New-DataEncryptionPolicy

Referencia

Módulo:: ExchangePowerShell

Se aplica a:: Exchange Online

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

Use el cmdlet New-DataEncryptionPolicy para crear 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.

Syntax

New-DataEncryptionPolicy
   [-Name] <String>
   -AzureKeyIDs <MultiValuedProperty>
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

Los cmdlets de directiva de cifrado de datos son la parte Exchange Online de la clave de cliente. Para obtener más información, consulte Control de los datos en Microsoft 365 mediante la clave de cliente.

Puede asignar una directiva de cifrado de datos a un buzón de correo mediante el parámetro DataEncryptionPolicy en el cmdlet Set-Mailbox en Exchange Online PowerShell.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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

New-DataEncryptionPolicy -Name "US Mailboxes" -AzureKeyIDs "https://contosoWestUSvault01.vault.azure.net/keys/USA_Key_01","https://contosoEastUSvault01.vault.azure.net/keys/USA_Key_02" -Description "Root key for mailboxes located in US territories"

En este ejemplo se crea una directiva de cifrado de datos denominada US Mailboxes con las claves y la descripción de Azure Key Vault especificadas.

Parámetros

-AzureKeyIDs

El parámetro AzureKeyIDs especifica los valores de URI de las claves de Azure Key Vault que se van a asociar a la directiva de cifrado de datos. Debe especificar al menos dos claves de Azure Key Vault separadas por comas. Por ejemplo, "https://contosoWestUSvault01.vault.azure.net/keys/USA_Key_01","https://contosoEastUSvault01.vault.azure.net/keys/USA_Key_02".

Para buscar el valor de URI de una Key Vault de Azure, reemplace por <VaultName> el nombre del almacén y ejecute este comando en Azure Rights Management PowerShell: Get-AzureKeyVaultKey -VaultName <VaultName>).id. Para obtener más información, consulte Acerca de Azure Key Vault.

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

-Confirm

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, 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 demás cmdlets (por ejemplo, los cmdlets 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.

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

-Description

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.

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

-DomainController

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

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

-Enabled

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

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

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

-Name

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

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

-WhatIf

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.

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