New-LabelPolicy
Questo cmdlet è disponibile solo in PowerShell conformità alla sicurezza & . Per altre informazioni, vedere PowerShell conformità alla sicurezza&.
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
New-LabelPolicy
-Name <String>
-Labels <MultiValuedProperty>
[-AdvancedSettings <PswsHashtable>]
[-Comment <String>]
[-Confirm]
[-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 Security & Compliance PowerShell, è 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
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 di etichettatura unificata di Azure Information Protection e non dalle app di Office che supportano l'etichettatura predefinita. Per istruzioni, vedere Configurazioni personalizzate per il client di etichettatura unificata di Azure Information Protection.
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"}
.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.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 vi sia più spazio per visualizzare nomi di file lunghi. Verranno 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.
Type: | PswsHashtable |
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 |
-ExchangeLocation
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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ExchangeLocationException
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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
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 |
-Labels
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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-MigrationId
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ModernGroupLocation
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 altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-ModernGroupLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Name
Il parametro Name consente di specificare il nome univoco per il criterio. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocation
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-OneDriveLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
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 |
-PublicFolderLocation
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-Setting
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 |
-Settings
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 |
-SharePointLocation
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SharePointLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SkypeLocation
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Security & Compliance |
-SkypeLocationException
Questo parametro è riservato all'uso interno da parte di Microsoft.
Type: | MultiValuedProperty |
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 |