Set-DataEncryptionPolicy

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online, Exchange Online Protection

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Usare il cmdlet Set-DataEncryptionPolicy per modificare i criteri di crittografia dei dati in Exchange Online.

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

Sintassi

Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   -PermanentDataPurgeReason <String>
   [-PermanentDataPurgeContact <String>]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Force]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   -PermanentDataPurgeContact <String>
   -PermanentDataPurgeReason <String>
   [-PermanentDataPurgeRequested]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Force]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-DataEncryptionPolicy
   [-Identity] <DataEncryptionPolicyIdParameter>
   [-Refresh]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Set-DataEncryptionPolicy -Identity "US Mailboxes" -Enabled $false

In questo esempio viene disabilitato il criterio di crittografia dei dati denominato US Mailboxes.

Esempio 2

Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh

In questo esempio vengono aggiornati i criteri di crittografia dei dati denominati Europe Mailboxes dopo che una delle chiavi associate è stata ruotata nel Key Vault di Azure.

Parametri

-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:Exchange Online, Exchange Online Protection

-Description

Il parametro Description specifica una descrizione facoltativa del criterio di crittografia dei dati. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-DomainController

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

Il parametro Enabled abilita o disabilita i criteri di crittografia dei dati. I valori validi sono:

  • $true: i criteri sono abilitati.
  • $true: il criterio è abilitato. Questo è il valore predefinito.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Force

L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.

Usare questa opzione per eliminare tutti i dati crittografati dai criteri di crittografia dei dati (l'opzione PermanentDataPurgeRequested), ma anche il Key Vault di Azure associato è stato eliminato.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Identity

Il parametro Identity consente di specificare il criterio di crittografia dei dati che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID
Type:DataEncryptionPolicyIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Name

Il parametro Name specifica il nome univoco del criterio di crittografia dei dati. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PermanentDataPurgeContact

Il parametro PermanentDataPurgeContact specifica un contatto per la pulizia di tutti i dati crittografati dal criterio di crittografia dei dati. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

È necessario utilizzare questo parametro con i parametri PermanentDataPurgeRequested e PermanentDataPurgeReason.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermanentDataPurgeReason

Il parametro PermanentDataPurgeReason specifica un motivo descrittivo per l'eliminazione di tutti i dati crittografati dai criteri di crittografia dei dati. Se il valore contiene spazi è necessario racchiuderlo tra virgolette.

È necessario utilizzare questo parametro con i parametri PermanentDataPurgeRequested e PermanentDataPurgeContact.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-PermanentDataPurgeRequested

L'opzione PermanentDataPurgeRequested specifica se avviare l'eliminazione di tutti i dati crittografati dai criteri di crittografia dei dati. Con questa opzione non è necessario specificare alcun valore.

È necessario utilizzare questa opzione con i parametri PermanentDataPurgeReason e PermanentDataPurgeContact.

Dopo aver utilizzato questa opzione, non è possibile assegnare il criterio di crittografia dei dati ad altre cassette postali.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Refresh

Usare l'opzione Aggiorna per aggiornare i criteri di crittografia dei dati in Exchange Online dopo aver ruotato una delle chiavi associate nel Key Vault di Azure. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-WhatIf

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection