Condividi tramite


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 etichetta 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 vengono creati i criteri di etichetta di riservatezza denominati Ricerca e sviluppo che contiene etichette di riservatezza denominate R e D e R e D Management.

Parametri

-AdvancedSettings

Applicabile: Conformità & sicurezza

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

Specificare questo parametro con l'identità (nome o GUID) dei criteri, 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 elementi, vedere Impostazioni avanzate per Microsoft Purview Information Protection client.

Impostazioni supportate per l'etichettatura predefinita:

  • AttachmentAction: i messaggi di posta elettronica senza etichetta ereditano l'etichetta con priorità più alta dagli allegati di file. Impostare il valore su Automatico (per applicare automaticamente l'etichetta) o Consigliato (come richiesta consigliata 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: impedire alle app di Office di inviare 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 per 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 Verifica & Revoca dal menu di riservatezza nei client di Office. App supportate: Word, Excel e PowerPoint in Windows (versione 2406+). Esempio: New-LabelPolicy -Identity Global -AdvancedSettings @{EnableRevokeGuiSupport="False"}. Per altre informazioni su questa scelta di configurazione, vedere Tenere traccia e revocare l'accesso ai documenti.

  • DisableMandatoryInOutlook: app di 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'etichettatura obbligatoria.

  • DisableShowSensitiveContent: per le app di Office che evidenziano il contenuto sensibile che ha causato la raccomandazione di un'etichetta, disattivare queste evidenziazioni e le indicazioni corrispondenti sul contenuto sensibile. Per altre informazioni, vedere Etichette di riservatezza 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 di 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'etichettatura obbligatoria.

  • TeamworkMandatory: 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 di Teams e chat.

  • teamworkdefaultlabelid: le app 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 di Teams e chat.

  • 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 che sia disponibile più spazio per visualizzare nomi di file lunghi. Vengono visualizzati solo l'icona dell'etichetta e il colore (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 di 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 predefiniti 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: Conformità & sicurezza

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: Conformità & sicurezza

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.

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: Conformità & sicurezza

{{ 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: Conformità & sicurezza

{{ 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: Conformità & sicurezza

Il parametro ExchangeLocation consente di specificare le cassette postali da includere nei criteri. 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: Conformità & sicurezza

Il parametro ExchangeLocationException consente di specificare le cassette postali da escludere quando si usa 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: Conformità & sicurezza

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.

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: Conformità & sicurezza

Il parametro Labels consente di specificare le etichette di riservatezza associate ai criteri. È 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: Conformità & sicurezza

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: Conformità & sicurezza

Il parametro ModernGroupLocation consente di specificare il Gruppi di Microsoft 365 da includere nei criteri. 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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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.

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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: Conformità & sicurezza

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.