Compartir a través de


Set-DataEncryptionPolicy

Este cmdlet solo está disponible en el servicio basado en la nube.

Use el cmdlet Set-DataEncryptionPolicy para modificar las directivas de cifrado de datos en Exchange Online.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

DCAdminPurgeKeyRequest

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

TenantAdminPurgeKeyRequest

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

RefreshKey

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

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

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

En este ejemplo se deshabilitó la directiva de cifrado de datos denominada Us Mailboxes.

Ejemplo 2

Set-DataEncryptionPolicy -Identity "Europe Mailboxes" -Refresh

En este ejemplo se actualiza la directiva de cifrado de datos denominada Buzones de Europa después de girar una de las claves asociadas en el Azure Key Vault.

Parámetros

-Confirm

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Este cmdlet tiene una pausa integrada, por lo que debe usar -Confirm:$false para omitir la confirmación.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Description

Aplicable: Exchange Online

El parámetro Description especifica una descripción opcional para la directiva de cifrado de datos. Si el valor contiene espacios, escríbalo entre comillas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Enabled

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro Enabled habilita o deshabilita la directiva de cifrado de datos. Los valores admitidos son:

  • $true: la directiva está habilitada.
  • $true: la directiva está habilitada. Es el valor predeterminado.

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Use este modificador para eliminar todos los datos cifrados por la directiva de cifrado de datos (el modificador PermanentDataPurgeRequested), pero también se ha eliminado el Azure Key Vault asociado.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TenantAdminPurgeKeyRequest
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DCAdminPurgeKeyRequest
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Online

El parámetro Identity especifica la directiva de cifrado de datos que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva la directiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Propiedades de parámetro

Tipo:DataEncryptionPolicyIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Name

Aplicable: Exchange Online

El parámetro Name especifica el nombre único de la directiva de cifrado de datos. Si el valor contiene espacios, escríbalo entre comillas.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PermanentDataPurgeContact

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro PermanentDataPurgeContact especifica un contacto para la purga de todos los datos cifrados por la directiva de cifrado de datos. Si el valor contiene espacios, escríbalo entre comillas.

Debe usar este parámetro con los parámetros PermanentDataPurgeRequested y PermanentDataPurgeReason.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TenantAdminPurgeKeyRequest
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DCAdminPurgeKeyRequest
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PermanentDataPurgeReason

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El parámetro PermanentDataPurgeReason especifica un motivo descriptivo para purgar todos los datos cifrados por la directiva de cifrado de datos. Si el valor contiene espacios, escríbalo entre comillas.

Debe usar este parámetro con los parámetros PermanentDataPurgeRequested y PermanentDataPurgeContact.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TenantAdminPurgeKeyRequest
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
DCAdminPurgeKeyRequest
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PermanentDataPurgeRequested

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador PermanentDataPurgeRequested especifica si se debe iniciar la eliminación de todos los datos cifrados por la directiva de cifrado de datos. No es necesario especificar un valor con este modificador.

Debe usar este modificador con los parámetros PermanentDataPurgeReason y PermanentDataPurgeContact.

Después de usar este modificador, no puede asignar la directiva de cifrado de datos a otros buzones.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

TenantAdminPurgeKeyRequest
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Refresh

Aplicable: Exchange Online

Use el modificador Actualizar para actualizar la directiva de cifrado de datos en Exchange Online después de girar cualquiera de las claves asociadas en el Azure Key Vault. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

RefreshKey
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Online, complemento de seguridad integrado para buzones locales

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.