New-ComplianceTag

{{ Fill AutoApprovalPeriod Description }}

Il parametro Comment consente di specificare un commento facoltativo. Se si specifica un valore che contiene degli spazi, è necessario racchiuderlo tra virgolette ("); ad esempio: "Questa è una nota per amministratori".

{{ Fill ComplianceTagForNextStage Description }}

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

• I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
• La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.

EventType specifica la regola di conservazione associata all'etichetta. È possibile utilizzare qualsiasi valore che identifichi la regola in modo univoco. Ad esempio:

• Nome
• Nome distinto (DN)
• GUID

È possibile usare il cmdlet Get-RetentionComplianceRule per visualizzare le regole di conservazione disponibili.

Il parametro FilePlanProperty consente di specificare le proprietà del piano di file da includere nell'etichetta. Per visualizzare i nomi delle proprietà del piano di file che è necessario usare in questo parametro, eseguire i comandi seguenti:

• Get-FilePlanPropertyAuthority | Format-List Name
• Get-FilePlanPropertyCategory | Format-List Name
• Get-FilePlanPropertyCitation | Format-List Name
• Get-FilePlanPropertyDepartment | Format-List Name
• Get-FilePlanPropertyReferenceId | Format-List Name
• Get-FilePlanPropertySubCategory | Format-List Name

Un valore valido per questo parametro prevede due passaggi:

• Variabile per archiviare le proprietà del piano file come PSCustomObject usando la sintassi seguente:

  $Variable1=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Name"},@{Key="FilePlanPropertyCategory";Value="Name"},@{Key="FilePlanPropertySubcategory";Value="Name"},@{Key="FilePlanPropertyCitation";Value="Name"},@{Key="FilePlanPropertyReferenceId";Value="Name"},@{Key="FilePlanPropertyAuthority";Value="Name"})}

  Ad esempio:

  $retentionLabelAction=[PSCustomObject]@{Settings=@(@{Key="FilePlanPropertyDepartment";Value="Legal"},@{Key="FilePlanPropertyCategory";Value="Tax"},@{Key="FilePlanPropertySubcategory";Value="US_Tax"},@{Key="FilePlanPropertyCitation";Value="LegalCitation"},@{Key="FilePlanPropertyReferenceId";Value="ReferenceA"},@{Key="FilePlanPropertyAuthority"; Value="Auth1"})}

• Seconda variabile per convertire PSCustomObject in un oggetto JSON usando la sintassi seguente:

  $Variable2 = ConvertTo-Json $Variable1

  Ad esempio:

  $fpStr = ConvertTo-Json $retentionLabelAction

La seconda variabile viene usata come valore per questo parametro.

Nota: questo parametro è attualmente disponibile in anteprima, non è disponibile in tutte le organizzazioni ed è soggetto a modifiche.

Il parametro FlowId specifica il flusso di Power Automate da eseguire alla fine del periodo di conservazione. Un valore valido per questo parametro è il valore GUID del flusso.

È possibile trovare il valore GUID del flusso usando uno dei metodi seguenti:

• Passare al flusso dal portale di Power Automate. Il valore GUID del flusso si trova nell'URL.
• Usare l'azione power automate denominata 'Elenca flussi come amministratore'.

L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.

Il parametro IsRecordLabel consente di specificare se l'etichetta è un'etichetta record. I valori validi sono:

• $true: l'etichetta è un'etichetta record. Dopo che l'etichetta viene applicata al contenuto, non è possibile rimuoverla.
• $false: l'etichetta non è un'etichetta record. Questo è il valore predefinito.

{{ Fill IsRecordUnlockedAsDefault Description }}

Il parametro MultiStageReviewProperty specifica le proprietà di revisione a più fasi da includere nell'etichetta. Il parametro utilizza la seguente sintassi:

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[reviewer1,reviewer2,...reviewerN]},{"StageName":"Stage2","Reviewers":[reviewer1,reviewer2,...reviewerN]},]}'

Ad esempio:

'{"MultiStageReviewSettings":[{"StageName":"Stage1","Reviewers":[jie@contoso.onmicrosoft.com]},{"StageName":"Stage2","Reviewers":[bharath@contoso.onmicrosoft.com,helen@contoso.onmicrosoft.com]},]}'

Questa sintassi è un oggetto JSON che definisce ogni ID fase di revisione, il nome della fase di revisione e l'elenco dei revisori.

Il parametro Name consente di specificare un nome univoco per l'etichetta. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Il parametro Notes consente di specificare informazioni aggiuntive sull'oggetto . Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

{{ Fill PriorityCleanup Description }}

{{ Fill Regulatory Description }}

Il parametro RetentionAction consente di specificare l'azione l'etichetta. I valori validi sono:

• Elimina
• Conservare
• KeepAndDelete

Il parametro RetentionDuration specifica per quanti giorni mantenere il contenuto. I valori validi sono:

• Un numero intero positivo.
• Valore illimitato.

Il parametro RetentionType specifica se la durata della conservazione viene calcolata dalla data di creazione del contenuto, dalla data con tag o dalla data dell'ultima modifica. I valori validi sono:

• CreationAgeInDays
• EventAgeInDays
• ModificationAgeInDays
• TaggedAgeInDays

Il parametro ReviewerEmail consente di specificare l'indirizzo di posta elettronica del revisore per le azioni di conservazione Delete e KeepAndDelete. È possibile indicare più indirizzi di posta elettronica separati da virgole.

Il parametro WhatIf non funziona in PowerShell per sicurezza e conformità.