Set-DataEncryptionPolicy

 

S’applique à :Exchange Online

Dernière rubrique modifiée :2017-07-17

Cette cmdlet est disponible uniquement dans le service en nuage.

Use the Set-DataEncryptionPolicy cmdlet to modify data encryption policies in Exchange Online.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Set-DataEncryptionPolicy <COMMON PARAMETERS>

Set-DataEncryptionPolicy -Refresh <SwitchParameter> <COMMON PARAMETERS>

Set-DataEncryptionPolicy -PermanentDataPurgeContact <String> -PermanentDataPurgeReason <String> -PermanentDataPurgeRequested <SwitchParameter> [-Force <SwitchParameter>] <COMMON PARAMETERS>

Set-DataEncryptionPolicy -PermanentDataPurgeReason <String> [-Force <SwitchParameter>] [-PermanentDataPurgeContact <String>] <COMMON PARAMETERS>

COMMON PARAMETERS: -Identity <DataEncryptionPolicyIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Name <String>] [-WhatIf [<SwitchParameter>]]

This example disabled the data encryption policy named US Mailboxes.

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

This example updates the data encryption policy named Europe Mailboxes after one of the associated keys has been rotated in the Azure Key Vault.

Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations nécessaires pour exécuter une cmdlet ou un paramètre dans votre organisation, consultez la rubrique Rechercher les autorisations requises pour exécuter les cmdlets Exchange.

 

Parameter Required Type Description

Identity

Required

Microsoft.Exchange.Configuration.Tasks.DataEncryptionPolicyIdParameter

The Identity parameter specifies the data encryption policy that you want to modify. You can use any value that uniquely identifies the policy. For example:

  • Name

  • Distinguished name (DN)

  • GUID

PermanentDataPurgeContact

Required

System.String

The PermanentDataPurgeContact parameter specifies a contact for the purge of all data that's encrypted by the data encryption policy. If the value contains spaces, enclose the value in quotation marks.

You need to use this parameter with the PermanentDataPurgeRequested and PermanentDataPurgeReason parameters.

PermanentDataPurgeReason

Required

System.String

The PermanentDataPurgeReason parameter specifies a descriptive reason for the purge of all data that's encrypted by the data encryption policy. If the value contains spaces, enclose the value in quotation marks.

You need to use this parameter with the PermanentDataPurgeRequested and PermanentDataPurgeContact parameters.

PermanentDataPurgeRequested

Required

System.Management.Automation.SwitchParameter

The PermanentDataPurgeRequested switch specifies whether to initiate the deletion of all data that's encrypted by the data encryption policy. You don't need to specify a value with this switch.

You need to use this switch with the PermanentDataPurgeReason and PermanentDataPurgeContact parameters.

After you use this switch, you can't assign the data encryption policy to other mailboxes.

Refresh

Required

System.Management.Automation.SwitchParameter

Use the Refresh switch to update the data encryption policy in Exchange Online after you rotate any of the associated keys in the Azure Key Vault. You don't need to specify a value with this switch.

Confirm

Optional

System.Management.Automation.SwitchParameter

Le commutateur Confirm spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Description

Optional

System.String

The Description parameter specifies an optional description for the data encryption policy. If the value contains spaces, enclose the value in quotation marks.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Ce paramètre est réservé à l’usage interne chez Microsoft.

Enabled

Optional

System.Boolean

The Enabled parameter enables or disable the data encryption policy. Valid values are:

  • $true   The policy is enabled.

  • $false   The policy is disabled.

Force

Optional

System.Management.Automation.SwitchParameter

Use the Force switch when you're trying to initiate the deletion of all data that's encrypted by the data encryption policy (the PermanentDataPurgeRequested switch), but the associated Azure Key Vault has also been deleted. You don't need to specify a value with this switch.

Name

Optional

System.String

The Name parameter specifies the unique name for the data encryption policy. If the value contains spaces, enclose the value in quotation marks.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: