Condividi tramite


New-Label

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

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

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

Sintassi

New-Label
   [-Name] <String>
   -DisplayName <String>
   -Tooltip <String>
   [-AdvancedSettings <PswsHashtable>]
   [-ApplyContentMarkingFooterAlignment <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment>]
   [-ApplyContentMarkingFooterEnabled <System.Boolean>]
   [-ApplyContentMarkingFooterFontColor <String>]
   [-ApplyContentMarkingFooterFontName <String>]
   [-ApplyContentMarkingFooterFontSize <System.Int32>]
   [-ApplyContentMarkingFooterMargin <System.Int32>]
   [-ApplyContentMarkingFooterText <String>]
   [-ApplyContentMarkingHeaderAlignment <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment>]
   [-ApplyContentMarkingHeaderEnabled <System.Boolean>]
   [-ApplyContentMarkingHeaderFontColor <String>]
   [-ApplyContentMarkingHeaderFontName <String>]
   [-ApplyContentMarkingHeaderFontSize <System.Int32>]
   [-ApplyContentMarkingHeaderMargin <System.Int32>]
   [-ApplyContentMarkingHeaderText <String>]
   [-ApplyWaterMarkingEnabled <System.Boolean>]
   [-ApplyWaterMarkingFontColor <String>]
   [-ApplyWaterMarkingFontName <String>]
   [-ApplyWaterMarkingFontSize <System.Int32>]
   [-ApplyWaterMarkingLayout <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+WaterMarkingLayout>]
   [-ApplyWaterMarkingText <String>]
   [-ColumnAssetCondition <String>]
   [-Comment <String>]
   [-Conditions <MultiValuedProperty>]
   [-Confirm]
   [-ContentType <MipLabelContentType>]
   [-DefaultContentLabel <String>]
   [-EncryptionAipTemplateScopes <String>]
   [-EncryptionContentExpiredOnDateInDaysOrNever <String>]
   [-EncryptionDoNotForward <System.Boolean>]
   [-EncryptionDoubleKeyEncryptionUrl <String>]
   [-EncryptionEnabled <System.Boolean>]
   [-EncryptionEncryptOnly <System.Boolean>]
   [-EncryptionLinkedTemplateId <String>]
   [-EncryptionOfflineAccessDays <System.Int32>]
   [-EncryptionPromptUser <System.Boolean>]
   [-EncryptionProtectionType <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType>]
   [-EncryptionRightsDefinitions <EncryptionRightsDefinitionsParameter>]
   [-EncryptionRightsUrl <String>]
   [-EncryptionTemplateId <String>]
   [-Identity <MasterIdParameter>]
   [-LabelActions <MultiValuedProperty>]
   [-LocaleSettings <MultiValuedProperty>]
   [-MigrationId <String>]
   [-ParentId <ComplianceRuleIdParameter>]
   [-SchematizedDataCondition <String>]
   [-Setting <PswsHashtable>]
   [-Settings <PswsHashtable>]
   [-SiteAndGroupProtectionAllowAccessToGuestUsers <System.Boolean>]
   [-SiteAndGroupProtectionAllowEmailFromGuestUsers <System.Boolean>]
   [-SiteAndGroupProtectionAllowFullAccess <System.Boolean>]
   [-SiteAndGroupProtectionAllowLimitedAccess <System.Boolean>]
   [-SiteAndGroupProtectionBlockAccess <System.Boolean>]
   [-SiteAndGroupProtectionEnabled <System.Boolean>]
   [-SiteAndGroupProtectionLevel <SiteAndGroupProtectionLevelParameter>]
   [-SiteAndGroupProtectionPrivacy <Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+GroupProtectionPrivacy>]
   [-SiteExternalSharingControlType <Microsoft.Office.CompliancePolicy.Tasks.SiteExternalSharingControlType>]
   [-TeamsAllowedPresenters <Microsoft.Office.CompliancePolicy.PolicyConfiguration.AllowedPresenters>]
   [-TeamsAllowMeetingChat <Microsoft.Office.CompliancePolicy.PolicyConfiguration.MeetingChatMode>]
   [-TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch <System.Boolean>]
   [-TeamsBypassLobbyForDialInUsers <System.Boolean>]
   [-TeamsChannelProtectionEnabled <System.Boolean>]
   [-TeamsChannelSharedWithExternalTenants <System.Boolean>]
   [-TeamsChannelSharedWithPrivateTeamsOnly <System.Boolean>]
   [-TeamsChannelSharedWithSameLabelOnly <System.Boolean>]
   [-TeamsCopyRestrictionEnforced <System.Boolean>]
   [-TeamsEndToEndEncryptionEnabled <System.Boolean>]
   [-TeamsLobbyBypassScope <Microsoft.Office.CompliancePolicy.PolicyConfiguration.LobbyBypassScope>]
   [-TeamsLobbyRestrictionEnforced <System.Boolean>]
   [-TeamsPresentersRestrictionEnforced <System.Boolean>]
   [-TeamsProtectionEnabled <System.Boolean>]
   [-TeamsRecordAutomatically <System.Boolean>]
   [-TeamsVideoWatermark <Microsoft.Office.CompliancePolicy.PolicyConfiguration.WaterMarkProtectionValues>]
   [-TeamsWhoCanRecord <Microsoft.Office.CompliancePolicy.PolicyConfiguration.WhoCanRecordOptions>]
   [-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-Label -DisplayName "My New label" -Name "New Label"

In questo esempio viene creata una nuova etichetta denominata "New Label" con il nome visualizzato "My New Label".

Parametri

-AdvancedSettings

Il parametro AdvancedSettings abilita funzionalità e funzionalità specifiche per un'etichetta di riservatezza.

Specificare questo parametro con l'identità (nome o GUID) dell'etichetta di riservatezza, 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 e dai servizi di Office che supportano l'etichettatura predefinita. Per un elenco di queste e istruzioni, vedere Configurazioni personalizzate per il client di etichettatura unificata di Azure Information Protection.

Impostazioni supportate per l'etichettatura predefinita:

  • Colore: specifica un colore dell'etichetta come codice tripletta esadecimale per i componenti rosso, verde e blu (RGB) del colore. Esempio: New-Label -DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{color="#40e0d0"}. Per altre informazioni, vedere Configurazione dei colori personalizzati tramite PowerShell.

  • DefaultSharingScope: specifica il tipo di collegamento di condivisione predefinito per un sito quando l'ambito dell'etichetta include siti gruppi &e il tipo di collegamento di condivisione predefinito per un documento quando l'ambito dell'etichetta include i messaggi di posta elettronica File&. I valori disponibili sono SpecificPeople, Organization e Anyone. Esempio: New-Label DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{DefaultSharingScope="SpecificPeople"}. Per altre informazioni, vedere Usare le etichette di riservatezza per configurare il tipo di collegamento di condivisione predefinito per siti e documenti in SharePoint e OneDrive.

  • DefaultShareLinkPermission: specifica le autorizzazioni per il collegamento di condivisione per un sito quando l'ambito dell'etichetta include siti gruppi &e le autorizzazioni per il collegamento di condivisione per un documento quando l'ambito dell'etichetta include i messaggi di posta elettronica File&. I valori disponibili sono Visualizza e Modifica. Esempio: New-Label DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{DefaultShareLinkPermission="Edit"}. Per altre informazioni, vedere Usare le etichette di riservatezza per configurare il tipo di collegamento di condivisione predefinito per siti e documenti in SharePoint e OneDrive.

  • DefaultShareLinkToExistingAccess: specifica se eseguire l'override di DefaultSharingScope e DefaultShareLinkPermission per impostare invece il tipo di collegamento di condivisione predefinito su utenti con accesso esistente con le autorizzazioni esistenti. Esempio: New-Label DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{DefaultShareLinkToExistingAccess="True"}. Per altre informazioni, vedere Usare le etichette di riservatezza per configurare il tipo di collegamento di condivisione predefinito per siti e documenti in SharePoint e OneDrive.

  • DefaultSubLabelId: specifica una sottoetichetta predefinita da applicare automaticamente quando un utente seleziona un'etichetta padre nelle app di Office. Esempio: New-Label -DisplayName "Confidential" -Name "Confidential" -Tooltip "Confidential data that requires protection, which allows all employees full permissions. Data owners can track and revoke content." -AdvancedSettings @{DefaultSubLabelId="8faca7b8-8d20-48a3-8ea2-0f96310a848e"}. Per altre informazioni, vedere Specificare un'etichetta secondaria predefinita per un'etichetta padre.

  • MembersCanShare: per un'etichetta del contenitore, specifica come i membri possono condividere per un sito di SharePoint. I valori disponibili sono MemberShareAll, MemberShareFileAndFolder e MemberShareNone. Esempio: New-Label -DisplayName "General" -Name "General" -Tooltip "Business data that is not intended for public consumption." -AdvancedSettings @{MembersCanShare="MemberShareFileAndFolder"}. Per altre informazioni, vedere Configurare le autorizzazioni di condivisione siti usando le impostazioni avanzate di PowerShell.

  • SMimeEncrypt: specifica la crittografia S/MIME per Outlook. I valori disponibili sono True e False (impostazione predefinita). Esempio: New-Label DisplayName "Confidential" -Name "Confidential" -Tooltip "Sensitive business data that could cause damage to the business if shared with unauthorized people." -AdvancedSettings @{SMimeEncrypt="True"}. Per altre informazioni, vedere Configurare un'etichetta per applicare la protezione S/MIME in Outlook.

  • SMimeSign: specifica la firma digitale S/MIME per Outlook. I valori disponibili sono True e False (impostazione predefinita). Esempio: New-Label DisplayName "Confidential" -Name "Confidential" -Tooltip "Sensitive business data that could cause damage to the business if shared with unauthorized people." -AdvancedSettings @{SMimeSign="True"}. Per altre informazioni, vedere Configurare un'etichetta per applicare la protezione S/MIME in Outlook.

Type:PswsHashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterAlignment

Il parametro ApplyContentMarkingFooterAlignment specifica l'allineamento del piè di pagina. I valori validi sono:

  • Sinistra
  • Centra
  • Right

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Type:Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterEnabled

Il parametro ApplyContentMarkingFooterEnabled abilita o disabilita l'azione Applica piè di pagina contrassegno contenuto per l'etichetta. I valori validi sono:

  • $true: l'azione Applica piè di pagina contrassegna contenuto è abilitata.
  • $false: l'azione Applica piè di pagina contrassegna contenuto è disabilitata.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterFontColor

Il parametro ApplyContentMarkingFooterFontColor specifica il colore del testo del piè di pagina. Questo parametro accetta un valore del codice colore esadecimale nel formato #xxxxxx. Il valore predefinito è #000000.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterFontName

Il parametro ApplyContentMarkingFooterFontName specifica il tipo di carattere del testo del piè di pagina. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). Ad esempio, "Courier New".

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Questo parametro è supportato solo da Azure Information Protection client di etichettatura unificata e non da app e servizi di Office che supportano l'etichettatura predefinita.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterFontSize

Il parametro ApplyContentMarkingFooterFontSize specifica la dimensione del carattere in punti del testo del piè di pagina.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterMargin

Il parametro ApplyContentMarkingFooterMargin specifica le dimensioni , in punti, del margine del piè di pagina.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Nota: in Microsoft Word, il valore specificato viene usato come margine inferiore e margine sinistro o margine destro per i segni di contenuto allineati a sinistra o a destra. È necessario un valore minimo di 15 punti. Word aggiunge anche un offset costante di 5 punti al margine sinistro per i segni di contenuto allineati a sinistra o al margine destro per i segni di contenuto allineati a destra.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingFooterText

Il parametro ApplyContentMarkingFooterText specifica il testo del piè di pagina. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingFooterEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderAlignment

Il parametro ApplyContentMarkingHeaderAlignment specifica l'allineamento dell'intestazione. I valori validi sono:

  • Sinistra
  • Centra
  • Right

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Type:Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+ContentAlignment
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderEnabled

Il parametro ApplyContentMarkingHeaderEnabled abilita o disabilita l'azione Applica intestazione contrassegno contenuto per l'etichetta. I valori validi sono:

  • $true: l'azione Applica intestazione contrassegno contenuto è abilitata.
  • $false: l'azione Applica intestazione contrassegno contenuto è disabilitata.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderFontColor

Il parametro ApplyContentMarkingHeaderFontColor specifica il colore del testo dell'intestazione. Questo parametro accetta un valore del codice colore esadecimale nel formato #xxxxxx. Il valore predefinito è #000000.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderFontName

Il parametro ApplyContentMarkingHeaderFontName specifica il tipo di carattere del testo dell'intestazione. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). Ad esempio, "Courier New".

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderFontSize

Il parametro ApplyContentMarkingHeaderFontSize specifica la dimensione del carattere (in punti) del testo dell'intestazione.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderMargin

Il parametro ApplyContentMarkingHeaderMargin specifica le dimensioni , in punti, del margine di intestazione.

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Nota: in Microsoft Word, il valore specificato viene usato come margine superiore e margine sinistro o margine destro per i segni di contenuto allineati a sinistra o a destra. È necessario un valore minimo di 15 punti. Word aggiunge anche un offset costante di 5 punti al margine sinistro per i segni di contenuto allineati a sinistra o al margine destro per i segni di contenuto allineati a destra.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyContentMarkingHeaderText

Il parametro ApplyContentMarkingHeaderText specifica il testo dell'intestazione. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Questo parametro è significativo solo quando il valore del parametro ApplyContentMarkingHeaderEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingEnabled

Il parametro ApplyWaterMarkingEnabled abilita o disabilita l'azione Applica intestazione filigrana per l'etichetta. I valori validi sono:

  • $true: l'azione Applica intestazione filigrana è abilitata.
  • $false: l'azione Applica intestazione filigrana è disabilitata.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingFontColor

Il parametro ApplyWaterMarkingFontColor specifica il colore del testo della filigrana. Questo parametro accetta un valore del codice colore esadecimale nel formato #xxxxxx. Il valore predefinito è #000000.

Questo parametro è significativo solo quando il valore del parametro ApplyWaterMarkingEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingFontName

Il parametro ApplyWaterMarkingFontName specifica il tipo di carattere del testo della filigrana. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette ("). Ad esempio, "Courier New".

Questo parametro è significativo solo quando il valore del parametro ApplyWaterMarkingEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingFontSize

Il parametro ApplyWaterMarkingFontSize consente di specificare le dimensioni del carattere , in punti, del testo della filigrana.

Questo parametro è significativo solo quando il valore del parametro ApplyWaterMarkingEnabled è $true o $false.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingLayout

Il parametro ApplyWaterMarkingLayout specifica l'allineamento della filigrana. I valori validi sono:

  • Orizzontale
  • Diagonale

Questo parametro è significativo solo quando il valore del parametro ApplyWaterMarkingEnabled è $true o $false.

Type:Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+WaterMarkingLayout
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ApplyWaterMarkingText

Il parametro ApplyWaterMarkingText specifica il testo della filigrana. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Questo parametro è significativo solo quando il valore del parametro ApplyWaterMarkingEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-ColumnAssetCondition

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

-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

-Conditions

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

Type:MulitValuedProperty
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

-ContentType

Il parametro ContentType specifica dove è possibile applicare l'etichetta di riservatezza. I valori validi sono:

  • File
  • Posta elettronica
  • Sito
  • UnifiedGroup
  • PurviewAssets
  • Lavoro in team
  • SchematizedData

I valori possono essere combinati, ad esempio: "File, Email, PurviewAssets".

Type:MipLabelContentType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-DefaultContentLabel

DefaultContentLabel specifica un'etichetta che può essere applicata automaticamente alle riunioni create in un canale teams con etichetta.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-DisplayName

Il parametro DisplayName consente di specificare il nome visualizzato per l'etichetta di riservatezza. Il nome visualizzato viene visualizzato in qualsiasi client che supporta le etichette di riservatezza. Sono inclusi Word, Excel, PowerPoint, Outlook, SharePoint, Teams e Power BI.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionAipTemplateScopes

Il parametro EncryptionAipTemplateScopes specifica che l'etichetta è ancora pubblicata e utilizzabile nel client AIP classico. Un valore di esempio è "['allcompany@labelaction.onmicrosoft.com','admin@labelaction.onmicrosoft.com']".

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionContentExpiredOnDateInDaysOrNever

Il parametro EncryptionContentExpiredOnDateInDaysOrNever specifica quando scade il contenuto crittografato. I valori validi sono:

  • Numero intero (numero di giorni)
  • Valore Never

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionDoNotForward

Il parametro EncryptionDoNotForward specifica se viene applicato il modello Non inoltrare. I valori validi sono:

  • $true: viene applicato il modello Non inoltrare.
  • $false: il modello Non inoltrare non viene applicato.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionDoubleKeyEncryptionUrl

La funzionalità per questo parametro è attualmente disponibile in anteprima pubblica e non è disponibile per tutti.

Il parametro EncryptionDoubleKeyEncryptionUrl specifica l'URL dell'endpoint di crittografia a chiave doppia.

Non è possibile rimuovere l'URL dopo la creazione dell'etichetta. è possibile modificarlo solo.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionEnabled

Il parametro EncryptionEnabled consente di specificare se la crittografia è abilitata. I valori validi sono:

  • $true: la crittografia è abilitata.
  • $false: la crittografia è disabilitata.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionEncryptOnly

Il parametro EncryptionEncryptOnly specifica se viene applicato il modello di sola crittografia. I valori validi sono:

  • $true: viene applicato il modello di sola crittografia.
  • $false: il modello di sola crittografia non viene applicato.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionLinkedTemplateId

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

-EncryptionOfflineAccessDays

Il parametro EncryptionOfflineAccessDays specifica il numero di giorni in cui è consentito l'accesso offline.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:System.Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionPromptUser

Il parametro EncryptionPromptUser consente di specificare se impostare l'etichetta con l'autorizzazione definita dall'utente in Word, Excel e PowerPoint. I valori validi sono:

  • $true: l'etichetta viene impostata con autorizzazioni definite dall'utente in Word, Excel e PowerPoint.
  • $false: l'etichetta non è impostata con autorizzazioni definite dall'utente in Word, Excel e PowerPoint.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false e quando il valore del parametro EncryptionProtectionType è UserDefined.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionProtectionType

Il parametro EncryptionProtectionType specifica il tipo di protezione per la crittografia. I valori validi sono:

  • Modello
  • RemoveProtection
  • Userdefined

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+SupportedProtectionType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionRightsDefinitions

Il parametro EncryptionRightsDefinitions specifica i diritti degli utenti quando accedono protetti. Questo parametro usa la sintassi Identity1:Rights1,Rights2;Identity2:Rights3,Rights4. Ad esempio, john@contoso.com:VIEW,EDIT;microsoft.com:VIEW.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false e il valore del parametro EncryptionProtectionType è Template.

Type:EncryptionRightsDefinitionsParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionRightsUrl

Il parametro EncryptionRightsUrl consente di specificare l'URL per la protezione HYOK (Hold Your Own Key).

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-EncryptionTemplateId

Il parametro EncryptionTemplateId consente di convertire un modello di protezione esistente da Azure Information Protection a una nuova etichetta di riservatezza. Specificare il modello in base al relativo ID che è possibile identificare eseguendo il cmdlet Get-AipServiceTemplate dal modulo PowerShell di AIPService.

Questo parametro è significativo solo quando il valore del parametro EncryptionEnabled è $true o $false.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Identity

Il parametro Identity viene usato per eseguire la migrazione di un'etichetta Information Protection di Azure esistente specificando un valore GUID.

Type:MasterIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-LabelActions

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

-LocaleSettings

Il parametro LocaleSettings consente di specificare uno o più nomi di etichette localizzate o descrizioni comandi delle etichette in lingue diverse. Sono inclusi tutti i codici di paese/area geografica supportati nelle applicazioni client di Office. I valori validi usano la sintassi seguente:

  • Nomi visualizzati delle etichette: {"localeKey":"DisplayName","Settings":[{"Key":"en-us","Value":"English display name"},{"Key":"de-de","Value":"Deutscher Anzeigename"},{"Key":"es-es","Value":"Nombre para mostrar en español"}]}
  • Descrizioni comando per le etichette: {"localeKey":"Tooltip","Settings":[{"Key":"en-us","Value":"English Tooltip"},{"Key":"de-de",Value":"Deutscher Tooltip"},{"Key":"es-es","Value":"Tooltip Español"}]}
Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
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

-Name

Il parametro Name consente di specificare il nome univoco per l'etichetta di riservatezza. 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

-ParentId

Il parametro ParentId specifica l'etichetta padre di questa etichetta. È possibile usare qualsiasi valore che identifichi l'etichetta di riservatezza padre in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:ComplianceRuleIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SchematizedDataCondition

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

-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

-SiteAndGroupProtectionAllowAccessToGuestUsers

Il parametro SiteAndGroupProtectionAllowAccessToGuestUsers abilita o disabilita l'accesso agli utenti guest. I valori validi sono:

  • $true: l'accesso guest è abilitato.
  • $false: l'accesso guest è disabilitato.

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionAllowEmailFromGuestUsers

Il parametro SiteAndGroupProtectionAllowEmailFromGuestUsers abilita o disabilita la posta elettronica degli utenti guest. I valori validi sono:

  • $true: è abilitata la Email dagli utenti guest.
  • $false: Email dagli utenti guest è disabilitato.

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionAllowFullAccess

Il parametro SiteAndGroupProtectionAllowFullAccess abilita o disabilita l'accesso completo. I valori validi sono:

  • $true: l'accesso completo è abilitato.
  • $false: l'accesso completo è disabilitato.

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionAllowLimitedAccess

Il parametro SiteAndGroupProtectionAllowLimitedAccess abilita o disabilita l'accesso limitato. I valori validi sono:

  • $true: l'accesso limitato è abilitato.
  • $false: l'accesso limitato è disabilitato.

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionBlockAccess

Il parametro SiteAndGroupProtectionBlockAccess blocca l'accesso. I valori validi sono:

  • $true: l'accesso è bloccato.
  • $false: l'accesso è consentito.

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionEnabled

Il parametro SiteAndGroupProtectionEnabled abilita o disabilita l'azione Protezione sito e gruppo per l'etichetta. I valori validi sono:

  • $true: l'azione Protezione sito e gruppo è abilitata.
  • $false: l'azione Protezione sito e gruppo è disabilitata.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionLevel

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

Type:SiteAndGroupProtectionLevelParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteAndGroupProtectionPrivacy

Il parametro SiteAndGroupProtectionPrivacy specifica il livello di privacy per il labe. I valori validi sono:

  • Pubblico
  • Private

Questo parametro è significativo solo quando il valore del parametro SiteAndGroupProtectionEnabled è $true o $false.

Type:Microsoft.Office.CompliancePolicy.Tasks.FlattenLabelActionUtils+GroupProtectionPrivacy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-SiteExternalSharingControlType

Il parametro SiteExternalSharingControlType specifica l'impostazione di condivisione utente esterna per l'etichetta. I valori validi sono:

  • ExternalUserAndGuestSharing
  • ExternalUserSharingOnly
  • ExistingExternalUserSharingOnly
  • Disabilitato

Queste corrispondono alle impostazioni seguenti tramite l'interfaccia di amministrazione:

  • Chiunque
  • Guest nuovi ed esistenti
  • Guest esistenti
  • Solo gli utenti dell'organizzazione
Type:Microsoft.Office.CompliancePolicy.Tasks.SiteExternalSharingControlType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsAllowedPresenters

Il parametro TeamsAllowedPresenters controlla chi può essere presente nelle riunioni di Teams. I valori validi sono:

  • Tutti
  • Organizzazione
  • Organizzatore
  • RoleIsPresenter
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:Microsoft.Office.CompliancePolicy.PolicyConfiguration.AllowedPresenters
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsAllowMeetingChat

Il parametro TeamsAllowMeetingChat controlla se la chat è disponibile nelle riunioni di Teams. I valori validi sono:

  • Abilitato
  • Disattivato
  • Limitato: la chat è disponibile solo per la durata della chiamata.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:Microsoft.Office.CompliancePolicy.PolicyConfiguration.MeetingChatMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch

{{ Fill TeamsAllowPrivateTeamsToBeDiscoverableUsingSearch Description }}

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsBypassLobbyForDialInUsers

Il parametro TeamsBypassLobbyForDialInUsers controlla l'esperienza della sala di attesa per gli utenti con accesso esterno che partecipano alle riunioni di Teams. I valori validi sono:

  • $true: gli utenti con accesso esterno ignorano la sala di attesa quando partecipano alle riunioni di Teams.
  • $false: gli utenti con accesso esterno non ignorano la sala di attesa quando partecipano alle riunioni di Teams.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsChannelProtectionEnabled

{{ Fill TeamsChannelProtectionEnabled Description }}

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsChannelSharedWithExternalTenants

{{ Fill TeamsChannelSharedWithExternalTenants Description }}

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsChannelSharedWithPrivateTeamsOnly

{{ Fill TeamsChannelSharedWithPrivateTeamsOnly Description }}

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsChannelSharedWithSameLabelOnly

{{ Fill TeamsChannelSharedWithSameLabelOnly Description }}

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsCopyRestrictionEnforced

Il parametro TeamsCopyRestrictionEnforced controlla se i messaggi di chat nelle riunioni di Teams possono essere copiati negli Appunti. I valori validi sono:

  • $true: i messaggi di chat possono essere copiati negli Appunti.
  • $false: i messaggi di chat non possono essere copiati negli Appunti.

Il valore $null (vuoto) consente agli utenti di configurare questa impostazione nell'app Teams.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsEndToEndEncryptionEnabled

Il parametro TeamsEndToEndEncryptionEnabled controlla la crittografia del flusso video nelle riunioni di Teams. I valori validi sono:

  • $true: la crittografia del flusso video è abilitata.
  • $false: la crittografia del flusso video non è abilitata.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.

Il valore $null (vuoto) consente agli utenti di configurare questa impostazione nell'app Teams.

Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsLobbyBypassScope

Il parametro TeamsLobbyBypassScope controlla chi ignora la sala di attesa quando si partecipa alle riunioni di Teams. I valori validi sono:

  • Tutti
  • Invitato
  • Organizzazione
  • OrganizationAndFederated
  • OrganizationExcludingGuests
  • Organizzatore
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:Microsoft.Office.CompliancePolicy.PolicyConfiguration.LobbyBypassScope
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsLobbyRestrictionEnforced

Il parametro TeamsLobbyRestrictionEnforced controlla se i partecipanti ignorano la sala di attesa quando partecipano alle riunioni di Teams. I valori validi sono:

  • $true: gli utenti ignorano la sala di attesa quando partecipano alle riunioni di Teams.
  • $false: gli utenti non ignorano la sala di attesa quando partecipano alle riunioni di Teams.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsPresentersRestrictionEnforced

Il parametro TeamsPresentersRestrictionEnforced controlla se le restrizioni dei relatori sono abilitate nelle riunioni di Teams. I valori validi sono:

  • $true: le restrizioni dei relatori sono abilitate nelle riunioni di Teams.
  • $false: le restrizioni dei relatori non sono abilitate nelle riunioni di Teams.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsProtectionEnabled

Il parametro TeamsProtectionEnabled controlla se la protezione di Teams è abilitata nelle riunioni di Teams. I valori validi sono:

  • $true: la protezione di Teams è abilitata nelle riunioni di Teams.
  • $false: la protezione di Teams non è abilitata nelle riunioni di Teams.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsRecordAutomatically

Il parametro TeamsRecordAutomatically controlla se le riunioni di Teams vengono registrate automaticamente dopo l'avvio. I valori validi sono:

  • $true: le riunioni di Teams vengono registrate automaticamente dopo l'avvio.
  • $false: le riunioni di Teams non vengono registrate automaticamente.
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:System.Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsVideoWatermark

Il parametro TeamsVideoWatermark controlla se una filigrana viene visualizzata nelle riunioni di Teams. I valori validi sono:

  • Nessuno
  • EnabledForContentSharing
  • EnabledForVideo
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:Microsoft.Office.CompliancePolicy.PolicyConfiguration.WaterMarkProtectionValues
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-TeamsWhoCanRecord

Il parametro TeamsWhoCanRecord controlla chi può registrare le riunioni di Teams. I valori validi sono:

  • Organizzatore
  • Coorganizzatori
  • Relatori
  • $null (vuoto): gli utenti configurano questa impostazione autonomamente nell'app Teams.
Type:Microsoft.Office.CompliancePolicy.PolicyConfiguration.WhoCanRecordOptions
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Security & Compliance

-Tooltip

Il parametro ToolTip specifica la descrizione predefinita della descrizione comando e dell'etichetta di riservatezza che vengono visualizzate dagli utenti. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:Named
Default value:None
Required:True
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