Condividi tramite

New-AutoSensitivityLabelPolicy

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

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

Usare il cmdlet New-AutoSensitivityLabelPolicy per creare criteri di etichettatura automatica nell'organizzazione. Creare regole dei criteri di etichettatura automatica usando il cmdlet New-AutoSensitivityLabelRule e associarle ai criteri per completare la creazione dei criteri.

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

Sintassi

New-AutoSensitivityLabelPolicy
   [-Name] <String>
   -ApplySensitivityLabel <String>
   [-Comment <String>]
   [-Confirm]
   [-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
   [-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-ExchangeAdaptiveScopes <MultiValuedProperty>]
   [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-ExchangeSender <SmtpAddress[]>]
   [-ExchangeSenderException <SmtpAddress[]>]
   [-ExchangeSenderMemberOf <SmtpAddress[]>]
   [-ExchangeSenderMemberOfException <SmtpAddress[]>]
   [-ExternalMailRightsManagementOwner <SmtpAddress>]
   [-Force]
   [-Locations <String>]
   [-Mode <PolicyMode>]
   [-OneDriveAdaptiveScopes <MultiValuedProperty>]
   [-OneDriveAdaptiveScopesException <MultiValuedProperty>]
   [-OneDriveLocation <MultiValuedProperty>]
   [-OneDriveLocationException <MultiValuedProperty>]
   [-OneDriveSharedBy <RecipientIdParameter[]>]
   [-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
   [-OverwriteLabel <Boolean>]
   [-PolicyRBACScopes <MultiValuedProperty>]
   [-PolicyTemplateInfo <PswsHashtable>]
   [-Priority <System.Int32>]
   [-SharePointAdaptiveScopes <MultiValuedProperty>]
   [-SharePointAdaptiveScopesException <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-SharePointLocationException <MultiValuedProperty>]
   [-UnifiedAuditLogEnabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Per usare questo cmdlet in PowerShell per sicurezza e conformità, è necessario disporre delle autorizzazioni. Per ulteriori informazioni, vedere Autorizzazioni nel portale di conformità di Microsoft Purview.

Esempio

Esempio 1

New-AutoSensitivityLabelPolicy -Name "GlobalPolicy" -Comment "Primary policy" -SharePointLocation "https://my.url","https://my.url2" -OneDriveLocation "https://my.url3","https://my.url4" -Mode TestWithoutNotifications -ApplySensitivityLabel "Test"

In questo esempio viene creato un criterio di etichettatura automatica denominato GlobalPolicy per SharePoint Online specificato e OneDrive for Business posizioni con l'etichetta "Test". Il nuovo criterio ha un commento descrittivo e sarà in modalità di simulazione al fine di creare.

Parametri

-ApplySensitivityLabel

Il parametro ApplySensitivityLabel consente di specificare l'etichetta da utilizzare per i criteri di etichettatura automatica.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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".

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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-*) 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.
Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExceptIfOneDriveSharedBy

Il parametro ExceptIfOneDriveSharedBy specifica gli utenti da escludere dai criteri (i siti degli account utente OneDrive for Business sono inclusi nei criteri). Si identificano gli utenti in base all'UPN (laura@contoso.onmicrosoft.com).

Per usare questo parametro, OneDrive for Business siti devono essere inclusi nel criterio (il valore del parametro OneDriveLocation è All, ovvero il valore predefinito).

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

Non è possibile usare questo parametro con il parametro OneDriveSharedBy.

Tipo:RecipientIdParameter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExceptIfOneDriveSharedByMemberOf

{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}

Tipo:RecipientIdParameter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExchangeAdaptiveScopes

{{ Fill ExchangeAdaptiveScopes Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExchangeAdaptiveScopesException

{{ Fill ExchangeAdaptiveScopesException Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExchangeLocation

Il parametro ExchangeLocation consente di specificare se includere i messaggi di posta elettronica nei criteri. Il valore valido per questo parametro è All. Se non si vuole includere messaggi di posta elettronica nel criterio, non usare questo parametro (il valore predefinito è vuoto o $null).

È possibile usare questo parametro nelle procedure seguenti:

  • Se si usa -ExchangeLocation 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 -ExchangeLocation All con il parametro ExchangeSender nello stesso comando. Nel criterio è incluso solo il messaggio di posta elettronica degli utenti specificati.

  • Per includere solo la posta elettronica di membri del gruppo specifici nel criterio, usare -ExchangeLocation 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 -ExchangeLocation 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 solo la posta elettronica di membri del gruppo specifici, usare -ExchangeLocation 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.

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExchangeSender

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

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

È necessario usare questo parametro con il parametro ExchangeLocation.

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

Tipo:SmtpAddress[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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, utilizzare la sintassi seguente: <value1>,<value2>,...<valueX>. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "<value1>","<value2>",..."<valueX>".

È necessario usare questo parametro con il parametro ExchangeLocation.

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

Tipo:SmtpAddress[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-ExchangeSenderMemberOf

Il parametro ExchangeSenderMemberOf consente di specificare 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). I gruppi vengono identificati in base all'indirizzo di posta elettronica.

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

È necessario usare questo parametro con il parametro ExchangeLocation.

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

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

Tipo:SmtpAddress[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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). I gruppi vengono identificati in base all'indirizzo di posta elettronica.

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

È necessario usare questo parametro con il parametro ExchangeLocation.

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

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

Tipo:SmtpAddress[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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.

Tipo:SmtpAddress
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-Locations

{{ Fill Locations Description }}

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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. Questo è il valore predefinito.
  • Enable: il criterio è abilitato per azioni e notifiche. Questo è il valore predefinito.
  • TestWithNotifications: non vengono eseguite azioni, ma vengono inviate notifiche.
  • TestWithoutNotifications: modalità di controllo in cui non vengono eseguite azioni e non vengono inviate notifiche.
Tipo:PolicyMode
Valori accettati:Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-Name

Il parametro Name consente di specificare un nome univoco per i criteri di etichettatura automatica. Se il valore contiene spazi, racchiudere il valore tra virgolette (").

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveAdaptiveScopes

{{ Fill OneDriveAdaptiveScopes Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveAdaptiveScopesException

{{ Fill OneDriveAdaptiveScopesException Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveLocation

Il parametro OneDriveLocation consente di specificare i siti OneDrive for Business da includere nei criteri. È possibile identificare il sito mediante il relativo valore URL oppure utilizzare il valore All per includere tutti i siti.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveLocationException

Questo parametro specifica i siti OneDrive for Business da escludere quando si usa il valore All per il parametro OneDriveLocation. È possibile identificare il sito mediante il relativo valore URL.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveSharedBy

Il parametro OneDriveSharedBy consente di specificare gli utenti da includere nei criteri (i siti degli account utente OneDrive for Business sono inclusi nei criteri). Si identificano gli utenti in base all'UPN (laura@contoso.onmicrosoft.com).

Per usare questo parametro, OneDrive for Business siti devono essere inclusi nel criterio (il valore del parametro OneDriveLocation è All, ovvero il valore predefinito).

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

Non è possibile usare questo parametro con il parametro ExceptIfOneDriveSharedBy.

Tipo:RecipientIdParameter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-OneDriveSharedByMemberOf

{{ Compilare OneDriveSharedByMemberOf Description }}

Tipo:RecipientIdParameter[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a: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.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-PolicyRBACScopes

Il parametro PolicyRBACScopes consente di specificare le unità amministrative da assegnare ai criteri. Un valore valido è il Microsoft Entra ObjectID (valore GUID) dell'unità amministrativa. È possibile specificare più valori separati da virgole.

Le unità amministrative sono disponibili solo in Microsoft Entra ID P1 o P2. È possibile creare e gestire unità amministrative in Microsoft Graph PowerShell.

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-PolicyTemplateInfo

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

Tipo:PswsHashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-Priority

Il parametro Priority consente di specificare la priorità dei criteri. Se per un file sono applicabili due criteri, i criteri con priorità più alta verranno applicati rispetto ai criteri con priorità inferiore.

Tipo:System.Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-SharePointAdaptiveScopes

{{ Fill SharePointAdaptiveScopes Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-SharePointAdaptiveScopesException

{{ Fill SharePointAdaptiveScopesException Description }}

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-SharePointLocation

Il parametro SharePointLocation consente di specificare i siti di SharePoint Online da includere nei criteri. È possibile identificare il sito mediante il relativo valore URL oppure utilizzare il valore All per includere tutti i siti.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN". I siti di SharePoint Online non possono essere aggiunti a un criterio fino a quando non sono stati indicizzati.

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-SharePointLocationException

Questo parametro specifica i siti di SharePoint Online da escludere quando si utilizza il valore All per il parametro SharePointLocation. È possibile identificare il sito mediante il relativo valore URL.

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".

Tipo:MultiValuedProperty
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-UnifiedAuditLogEnabled

{{ Fill UnifiedAuditLogEnabled Description }}

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False
Si applica a:Security & Compliance