Condividi tramite


New-AutoSensitivityLabelPolicy

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 le posizioni di SharePoint e OneDrive specificate 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 di OneDrive sono inclusi nei criteri). Si identificano gli utenti in base all'UPN ([email protected]).

Per usare questo parametro, i siti di OneDrive devono essere inclusi nei criteri (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 di OneDrive 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 di OneDrive 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 specifica gli utenti da includere nei criteri (i siti degli account utente di OneDrive sono inclusi nei criteri). Si identificano gli utenti in base all'UPN ([email protected]).

Per usare questo parametro, i siti di OneDrive devono essere inclusi nei criteri (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 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 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 da escludere quando si usa 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