Set-DataEncryptionPolicy

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