New-ComplianceTag
Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.
Usare il cmdlet New-ComplianceTag per creare etichette di conservazione nel Portale di conformità di Microsoft Purview. Le etichette di conservazione applicano le impostazioni di conservazione al contenuto.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-ComplianceTag
[-Name] <String>
[-Comment <String>]
[-ComplianceTagForNextStage <String>]
[-Confirm]
[-EventType <ComplianceRuleIdParameter>]
[-FilePlanProperty <String>]
[-FlowId <System.Guid>]
[-Force]
[-IsRecordLabel <Boolean>]
[-IsRecordUnlockedAsDefault <Boolean>]
[-MultiStageReviewProperty <String>]
[-Notes <String>]
[-Regulatory <Boolean>]
[-RetentionAction <String>]
[-RetentionDuration <Unlimited>]
[-RetentionType <String>]
[-ReviewerEmail <SmtpAddress[]>]
[-WhatIf]
[<CommonParameters>]
Descrizione
Per usare questo cmdlet in Security & Compliance PowerShell, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.
Esempio
Esempio 1
New-ComplianceTag -Name "HR Content" -RetentionAction Keep -RetentionDuration 1825 -RetentionType ModificationAgeInDays
In questo esempio viene creata una nuova etichetta denominata HR Content con le seguenti impostazioni:
- Azione: mantieni.
- Durata: 5 anni (1825 giorni)
- Tipo: età di modifica in giorni.
Parametri
-Comment
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".
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ComplianceTagForNextStage
{{ Fill ComplianceTagForNextStage Description }}
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Confirm
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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-EventType
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.
Type: | ComplianceRuleIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-FilePlanProperty
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="Referen
ceA"},@{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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-FlowId
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'.
Type: | System.Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Force
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-IsRecordLabel
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-IsRecordUnlockedAsDefault
{{ Fill IsRecordUnlockedAsDefault Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MultiStageReviewProperty
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Il parametro Name consente di specificare un nome univoco per l'etichetta. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Notes
Il parametro Notes consente di specificare informazioni aggiuntive sull'oggetto . Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Regulatory
{{ Fill Regulatory Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionAction
Il parametro RetentionAction consente di specificare l'azione l'etichetta. I valori validi sono:
- Elimina
- Conservare
- KeepAndDelete
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionDuration
Il parametro RetentionDuration specifica per quanti giorni mantenere il contenuto. I valori validi sono:
- Un numero intero positivo.
- Valore illimitato.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-RetentionType
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
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ReviewerEmail
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.
Type: | SmtpAddress[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-WhatIf
L'opzione WhatIf non funziona in PowerShell per la conformità alla sicurezza & .
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |