New-LabelPolicy

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

Usare il cmdlet New-LabelPolicy per creare criteri di etichette di riservatezza nell'organizzazione.

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

Sintassi

Default (Impostazione predefinita)

New-LabelPolicy
    -Name <String>
    -Labels <MultiValuedProperty>
    [-AdvancedSettings <PswsHashtable>]
    [-Comment <String>]
    [-Confirm]
    [-ExchangeAdaptiveScopes <MultiValuedProperty>]
    [-ExchangeAdaptiveScopesException <MultiValuedProperty>]
    [-ExchangeLocation <MultiValuedProperty>]
    [-ExchangeLocationException <MultiValuedProperty>]
    [-Force]
    [-MigrationId <String>]
    [-ModernGroupLocation <MultiValuedProperty>]
    [-ModernGroupLocationException <MultiValuedProperty>]
    [-OneDriveLocation <MultiValuedProperty>]
    [-OneDriveLocationException <MultiValuedProperty>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PublicFolderLocation <MultiValuedProperty>]
    [-Setting <PswsHashtable>]
    [-Settings <PswsHashtable>]
    [-SharePointLocation <MultiValuedProperty>]
    [-SharePointLocationException <MultiValuedProperty>]
    [-SkypeLocation <MultiValuedProperty>]
    [-SkypeLocationException <MultiValuedProperty>]
    [-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-LabelPolicy -Name "Research and Development" -Labels "R and D","R and D Management"

In questo esempio viene creato il criterio di etichetta di riservatezza denominato Ricerca e sviluppo che contiene etichette di riservatezza denominate R e S e Gestione R e S.

Parametri

-AdvancedSettings

Applicabile: Sicurezza & conformità

Il parametro AdvancedSettings abilita le funzionalità e le funzionalità specifiche del client per i criteri di etichetta di riservatezza.

Specificare questo parametro con l'identità (nome o GUID) del criterio, con coppie chiave/valore in una tabella hash. Per rimuovere un'impostazione avanzata, usare la stessa sintassi del parametro AdvancedSettings, ma specificare un valore stringa Null.

Alcune delle impostazioni configurate con questo parametro sono supportate solo dal client Microsoft Purview Information Protection e non dalle app e dai servizi di Office che supportano l'etichettatura predefinita. Per un elenco di questi, vedere Impostazioni avanzate per il client Microsoft Purview Information Protection.

Impostazioni supportate per l'etichettatura predefinita:

  • AttachmentAction: i messaggi di posta elettronica senza etichetta ereditano l'etichetta di priorità più alta dagli allegati. Impostare il valore su Automatico (per applicare automaticamente l'etichetta) o Consigliato (come prompt consigliato all'utente). Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{AttachmentAction="Automatic"}. Per altre informazioni su questa scelta di configurazione, vedere Configurare l'ereditarietà delle etichette dagli allegati di posta elettronica.

  • EnableAudit: impedisce alle app di Office di inviare i dati delle etichette di riservatezza alle soluzioni di controllo di Microsoft 365. App supportate: Word, Excel e PowerPoint in Windows (versione 2201+), macOS (versione 16.57+), iOS (versione 2.57+) e Android (versione 16.0.14827+); Outlook su Windows (versione 2201+), Outlook sul web e distribuzione in macOS, iOS e Android. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{EnableAudit="False"}.

  • EnableRevokeGuiSupport: rimuovere il pulsante Traccia & Revoca dal menu riservatezza nei client di Office. App supportate: Word, Excel e PowerPoint in Windows (versione 2406+). Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}. Per ulteriori informazioni su questa scelta di configurazione, consulta Tracciare e revocare l'accesso ai documenti.

  • DisableMandatoryInOutlook: le app Outlook che supportano questa impostazione esentano i messaggi di Outlook dall'etichettatura obbligatoria. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{DisableMandatoryInOutlook="True"}. Per altre informazioni su questa scelta di configurazione, vedere Opzioni specifiche di Outlook per l'etichetta predefinita e l'etichetta obbligatoria.

  • DisableShowSensitiveContent: per le app di Office che evidenziano il contenuto riservato che ha causato una raccomandazione di un'etichetta, disattivare queste evidenziazioni e le indicazioni corrispondenti sul contenuto sensibile. Per altre informazioni, vedere Le etichette di riservatezza vengono applicate automaticamente o consigliate per i file e i messaggi di posta elettronica in Office. App supportate: Word per Windows (versione 2311+). Esempio: Set-LabelPolicy -Identity Global -AdvancedSettings @{DisableShowSensitiveContent="True"}

  • OutlookDefaultLabel: le app Outlook che supportano questa impostazione applicano un'etichetta predefinita o nessuna etichetta. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{OutlookDefaultLabel="None"}. Per altre informazioni su questa scelta di configurazione, vedere Opzioni specifiche di Outlook per l'etichetta predefinita e l'etichetta obbligatoria.

  • Lavoro in teamObbligatorio: le app Outlook e Teams che supportano questa impostazione possono abilitare o disabilitare l'etichettatura obbligatoria per le riunioni. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{TeamworkMandatory="True"}. Per altre informazioni sull'etichettatura delle riunioni, vedere Usare le etichette di riservatezza per proteggere elementi del calendario, riunioni e chat di Teams.

  • teamworkDefaultLabelId: le app di Outlook e Teams che supportano questa impostazione applicano un'etichetta predefinita o nessuna etichetta per le riunioni. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{teamworkdefaultlabelid="General"}. Per altre informazioni sull'etichettatura delle riunioni, vedere Usare le etichette di riservatezza per proteggere elementi del calendario, riunioni e chat di Teams.

  • HideBarByDefault: per le app di Office che supportano la barra di riservatezza, non visualizzare il nome dell'etichetta di riservatezza nel titolo della barra della finestra, in modo da avere più spazio per visualizzare nomi di file lunghi. Vengono visualizzati solo l'icona e il colore dell'etichetta (se configurati). Gli utenti non possono ripristinare questa impostazione nell'app. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{HideBarByDefault="True"}

Inoltre, per Power BI:

  • powerbimandatory: etichettatura obbligatoria per Power BI. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{powerbimandatory="true"}. Per altre informazioni su questa scelta di configurazione, vedere Criteri etichetta obbligatori per Power BI.

  • powerbidefaultlabelid: etichetta predefinita per il contenuto di Power BI. Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{powerbidefaultlabelid="General"}. Per altre informazioni su questa scelta di configurazione, vedere Criteri di etichetta predefinita per Power BI.

Proprietà dei parametri

Tipo:PswsHashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Comment

Applicabile: Sicurezza & conformità

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".

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Sicurezza & conformità

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma 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, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExchangeAdaptiveScopes

Applicabile: Sicurezza & conformità

{{ Fill ExchangeAdaptiveScopes Description }}

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExchangeAdaptiveScopesException

Applicabile: Sicurezza & conformità

{{ Fill ExchangeAdaptiveScopesException Description }}

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExchangeLocation

Applicabile: Sicurezza & conformità

Il parametro ExchangeLocation consente di specificare le cassette postali da includere nel criterio. Un valore valido è una cassetta postale.

Per specificare la cassetta postale, è possibile usare qualsiasi valore che la identifichi in modo univoco. Ad esempio:

  • Nome
  • Nome
  • Indirizzo di posta elettronica
  • GUID

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExchangeLocationException

Applicabile: Sicurezza & conformità

Il parametro ExchangeLocationException consente di specificare le cassette postali da escludere quando si utilizza il valore All per il parametro ExchangeLocation. Un valore valido è una cassetta postale.

Per specificare la cassetta postale, è possibile usare qualsiasi valore che la identifichi in modo univoco. Ad esempio:

  • Nome
  • Nome
  • Indirizzo di posta elettronica
  • GUID

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Applicabile: Sicurezza & conformità

L'interruttore di 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Labels

Applicabile: Sicurezza & conformità

Il parametro Labels consente di specificare le etichette di riservatezza associate al criterio. È possibile usare qualsiasi valore che identifichi l'etichetta in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MigrationId

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ModernGroupLocation

Applicabile: Sicurezza & conformità

Il parametro ModernGroupLocation consente di specificare i Gruppi di Microsoft 365 da includere nel criterio. Per identificare il gruppo di Microsoft 365, è necessario usare l'indirizzo SMTP primario.

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ModernGroupLocationException

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Default
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Applicabile: Sicurezza & conformità

Il parametro Nome specifica il nome univoco del criterio. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OneDriveLocation

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OneDriveLocationException

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PolicyRBACScopes

Applicabile: Sicurezza & conformità

Il parametro PolicyRBACScopes consente di specificare le unità amministrative da assegnare al criterio. Un valore valido è l'ObjectID di Microsoft Entra (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.

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PublicFolderLocation

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Setting

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:PswsHashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Settings

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:PswsHashtable
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SharePointLocation

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SharePointLocationException

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SkypeLocation

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SkypeLocationException

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:MultiValuedProperty
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Sicurezza & conformità

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.