Condividi tramite

Set-AutoSensitivityLabelPolicy

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Security & Compliance

Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.

Usare il cmdlet Set-AutoSensitivityLabelPolicy per modificare i criteri di etichettatura automatica nell'organizzazione.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-AddExchangeLocation <MultiValuedProperty>]
   [-AddOneDriveLocation <MultiValuedProperty>]
   [-AddOneDriveLocationException <MultiValuedProperty>]
   [-AddSharePointLocation <MultiValuedProperty>]
   [-AddSharePointLocationException <MultiValuedProperty>]
   [-ApplySensitivityLabel <String>]
   [-AutoEnableAfter <Timespan>]
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Mode <PolicyMode>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-RemoveExchangeLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocation <MultiValuedProperty>]
   [-RemoveOneDriveLocationException <MultiValuedProperty>]
   [-RemoveSharePointLocation <MultiValuedProperty>]
   [-RemoveSharePointLocationException <MultiValuedProperty>]
   [-SpoAipIntegrationEnabled <Boolean>]
   [-StartSimulation <Boolean>]
   [-SystemOperation]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-Force]
   [-Mode <PolicyMode>]
   [-WhatIf]
   [<CommonParameters>]
Set-AutoSensitivityLabelPolicy
   [-Identity] <PolicyIdParameter>
   [-Confirm]
   [-Mode <PolicyMode>]
   [-RetryDistribution]
   [-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

Set-AutoSensitivityLabelPolicy -Identity "Main PII" -AddSharePointLocation "https://my.url1","https://my.url2" -AddOneDriveLocation "https://my.url3","https://my.url4"

In questo esempio vengono aggiunti gli URL specificati ai percorsi di SharePoint Online e OneDrive for Business per il criterio di etichettatura automatica denominato Informazioni personali principali senza influire sui valori URL esistenti.

Parametri

-AddExchangeLocation

Il parametro AddExchangeLocation aggiunge messaggi di posta elettronica ai criteri se non sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio non include già messaggi di posta elettronica (nell'output del cmdlet Get-AutoSensitivityLabelPolicy il valore della proprietà ExchangeLocation è vuoto), è possibile usare questo parametro nelle procedure seguenti:

  • Se si usa -AddExchangeLocation All da solo, il criterio si applica alla posta elettronica per tutti gli utenti interni.

  • Per includere la posta elettronica di utenti interni o esterni specifici nei criteri, usare -AddExchangeLocation All con il parametro ExchangeSender nello stesso comando. Nel criterio è incluso solo il messaggio di posta elettronica degli utenti specificati.

  • Per includere la posta elettronica di membri del gruppo specifici nei criteri, usare -AddExchangeLocation All con il parametro ExchangeSenderMemberOf nello stesso comando. Nei criteri è incluso solo il messaggio di posta elettronica dei membri dei gruppi specificati.

  • Per escludere la posta elettronica di utenti interni specifici dai criteri, usare -AddExchangeLocation All con il parametro ExchangeSenderException nello stesso comando. Solo i messaggi di posta elettronica degli utenti specificati vengono esclusi dai criteri.

  • Per escludere dal criterio la posta elettronica di membri del gruppo specifici, usare -AddExchangeLocation All con il parametro ExchangeSenderMemberOfException nello stesso comando. Solo i messaggi di posta elettronica dei membri dei gruppi specificati vengono esclusi dai criteri.

Non è possibile specificare inclusioni ed esclusioni nello stesso criterio.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocation

Il parametro AddOneDriveLocation specifica il OneDrive for Business siti da aggiungere all'elenco dei siti inclusi quando non si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddOneDriveLocationException

Il parametro AddOneDriveLocationException specifica il OneDrive for Business siti da aggiungere all'elenco dei siti esclusi quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocation

Il parametro AddSharePointLocation consente di specificare i siti di SharePoint Online da aggiungere all'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

I siti di SharePoint Online non possono essere aggiunti ai criteri finché non sono stati indicizzati.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AddSharePointLocationException

Il parametro AddSharePointLocationException consente di specificare i siti di SharePoint Online da aggiungere all'elenco dei siti esclusi quando si utilizza il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplySensitivityLabel

Il parametro ApplySensitivityLabel consente di selezionare l'etichetta da usare per i criteri. Questo eseguirà l'override dell'etichetta precedente nei criteri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-AutoEnableAfter

Il parametro AutoEnableAfter consente di attivare automaticamente i criteri dopo un periodo di tempo impostato nella simulazione. Il periodo di tempo viene riavviato ogni volta che si modificano i criteri o quando viene attivata una simulazione.

Per specificare un valore, immetterlo come intervallo di tempo: dd.hh:mm:ss dove dd = giorni, hh = ore, mm = minuti e ss = secondi.

Un valore valido è compreso tra 1 ora e 25 giorni.

È necessario usare questo parametro con il parametro -StartSimulation.

Type:System.TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-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

-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

-Enabled

Il parametro Enabled abilita o disabilita i criteri. I valori validi sono:

  • $true: i criteri sono abilitati. Questo è il valore predefinito.
  • $true: il criterio è abilitato. 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

-ExchangeSender

Il parametro ExchangeSender consente di specificare gli utenti il cui messaggio di posta elettronica è incluso nei criteri. Specificare gli utenti in base all'indirizzo di posta elettronica. È possibile specificare indirizzi di posta elettronica interni o esterni.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output del cmdlet Get-AutoSensitivityLabelPolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con i parametri ExchangeSenderException o ExchangeSenderMemberOfException.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderException

Il parametro ExchangeSenderException consente di specificare gli utenti interni il cui messaggio di posta elettronica è escluso dai criteri. Si identificano gli utenti in base all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output di Get-AutoSensitivityLabelPolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con i parametri ExchangeSender o ExchangeSenderMemberOf.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOf

Il parametro ExchangeSenderMemberOf specifica i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da includere nei criteri (la posta elettronica dei membri del gruppo è inclusa nei criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output di Get-AutoSensitivityLabelPolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con i parametri ExchangeSenderException o ExchangeSenderMemberOfException.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExchangeSenderMemberOfException

Il parametro ExchangeSenderMemberOfException consente di specificare i gruppi di distribuzione o i gruppi di sicurezza abilitati alla posta elettronica da escludere dai criteri (la posta elettronica dei membri del gruppo è esclusa dai criteri). Si identificano i gruppi in base all'indirizzo di posta elettronica.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Per usare questo parametro, una delle istruzioni seguenti deve essere true:

  • Il criterio include già i messaggi di posta elettronica (nell'output di Get-AutoSensitivityLabelPolicy, il valore della proprietà ExchangeLocation è All).
  • Usare -AddExchangeLocation All nello stesso comando con questo parametro.

Non è possibile usare questo parametro con i parametri ExchangeSender o ExchangeSenderMemberOf.

Non è possibile usare questo parametro per specificare Gruppi di Microsoft 365.

Type:SmtpAddress[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ExternalMailRightsManagementOwner

Il parametro ExternalMailRightsManagementOwner specifica l'indirizzo di posta elettronica di una cassetta postale utente usata per crittografare i messaggi di posta elettronica in ingresso da mittenti esterni tramite RMS.

Questo parametro funziona solo nei percorsi di Exchange e i criteri devono applicare un'etichetta con un'azione di crittografia.

Per cancellare un indirizzo di posta elettronica esistente, usare il valore $null.

Type:SmtpAddress
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

-Identity

Il parametro Identity consente di specificare i criteri di etichettatura automatica che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:PolicyIdParameter
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Security & Compliance

-Mode

Il parametro Mode consente di specificare il livello di azione e notifica dei criteri di etichettatura automatica. I valori validi sono:

  • Abilita: i criteri sono abilitati per le azioni e le notifiche.
  • Disabilita: il criterio è disabilitato.
  • TestWithNotifications: non supportato.
  • TestWithoutNotifications: modalità di controllo in cui non vengono eseguite azioni e non vengono inviate notifiche (modalità di test).
Type:PolicyMode
Accepted values:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-OverwriteLabel

Il parametro OverwriteLabel consente di specificare se sovrascrivere un'etichetta manuale. I valori validi sono:

  • $true: sovrascrivere l'etichetta manuale.
  • $false: non sovrascrivere l'etichetta manuale. Questo è il valore predefinito.

Questo parametro funziona solo nei percorsi di Exchange.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PolicyRBACScopes

{{ Fill PolicyRBACScopes Description }}

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-PolicyTemplateInfo

Questo parametro è riservato all'uso interno da parte di Microsoft.

Type:PswsHashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Priority

Il parametro Priority consente di specificare un valore di priorità per il criterio che determina l'ordine di elaborazione dei criteri. Un valore intero inferiore indica una priorità più alta, il valore 0 è la priorità più alta e i criteri non possono avere lo stesso valore di priorità.

I valori validi e il valore predefinito per questo parametro dipendono dal numero di criteri esistenti. Ad esempio, se sono presenti 5 criteri esistenti:

  • I valori di priorità validi per i 5 criteri esistenti sono compresi tra 0 e 4.
  • I valori di priorità validi per un nuovo 6° criterio sono compresi tra 0 e 5.
  • Il valore predefinito per un nuovo 6° criterio è 5.

Se si modifica il valore di priorità di un criterio, la posizione dei criteri nell'elenco cambia in base al valore di priorità specificato. In altre parole, se si imposta il valore di priorità di un criterio sullo stesso valore di un criterio esistente, il valore di priorità dei criteri esistenti e di tutti gli altri criteri con priorità inferiore dopo che è stato aumentato di 1.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveExchangeLocation

Il parametro RemoveExchangeLocation rimuove i messaggi di posta elettronica dai criteri, se sono già inclusi. Il valore valido per questo parametro è All.

Se il criterio include già messaggi di posta elettronica (nell'output del cmdlet Get-AutoSensitivityLabelPolicy, il valore della proprietà ExchangeLocation è All), è possibile usare -RemoveExchangeLocation All per impedire l'applicazione dei criteri ai messaggi di posta elettronica.

Non è possibile usare questo parametro se la posta elettronica (il valore Exchange) viene usata da una delle regole associate.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocation

Il parametro RemoveOneDriveLocation specifica i siti OneDrive for Business da rimuovere dall'elenco dei siti inclusi quando non si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveOneDriveLocationException

Questo parametro RemoveOneDriveLocationException specifica i siti OneDrive for Business da rimuovere dall'elenco dei siti esclusi quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocation

Il parametro RemoveSharePointLocation consente di specificare i siti di SharePoint Online da rimuovere dall'elenco dei siti inclusi quando non si usa il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RemoveSharePointLocationException

Il parametro RemoveSharePointLocationException consente di specificare i siti di SharePoint Online da rimuovere dall'elenco dei siti esclusi quando si utilizza il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

Per immettere più valori, usare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-RetryDistribution

L'opzione RetryDistribution ridistribuisce i criteri in tutte le posizioni di OneDrive for Business e SharePoint Online. Con questa opzione non è necessario specificare alcun valore.

I percorsi le cui distribuzioni iniziali hanno avuto esito positivo non sono inclusi nel tentativo. Quando si utilizza questa opzione, vengono segnalati gli errori di distribuzione dei criteri.

Nota: poiché il processo di ripetizione della distribuzione è un'operazione significativa, eseguirlo solo se necessario e per un criterio alla volta. Non è progettato per essere eseguito ogni volta che si aggiorna un criterio. Se si esegue uno script per aggiornare più criteri, attendere il completamento della distribuzione dei criteri prima di eseguire di nuovo il comando per i criteri successivi.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SpoAipIntegrationEnabled

{{ Fill SpoAipIntegrationEnabled Description }}

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-StartSimulation

Usare il parametro StartSimulation per riavviare la simulazione per ottenere risultati aggiornati. I valori validi sono:

  • $true: riavviare la simulazione per ottenere risultati aggiornati.
  • $false: valore predefinito
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SystemOperation

{{ Fill SystemOperation Description }}

Type:SwitchParameter
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