Compartir a través de

Set-AzRecoveryServicesVaultProperty

  • Referencia
Módulo:
Az.RecoveryServices

Actualiza las propiedades de un almacén.

Sintaxis

Set-AzRecoveryServicesVaultProperty
   [-SoftDeleteFeatureState <String>]
   [-SoftDeleteRetentionPeriodInDays <Int32>]
   [-DisableHybridBackupSecurityFeature <Boolean>]
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzRecoveryServicesVaultProperty
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-Token <String>]
   -EncryptionKeyId <String>
   [-KeyVaultSubscriptionId <String>]
   [-InfrastructureEncryption]
   [-UseSystemAssignedIdentity <Boolean>]
   [-UserAssignedIdentity <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzRecoveryServicesVaultProperty actualiza las propiedades de un almacén de Recovery Services. Este cmdlet se puede usar para habilitar, deshabilitar o deshabilitar o establecer el cifrado de CMK para un almacén con dos conjuntos de parámetros diferentes. propiedad softDeleteFeatureState de un almacén solo se puede deshabilitar si no hay contenedores registrados en el almacén. La infraestructuraturEncryption solo se puede establecer la primera vez que un usuario actualiza el almacén de CMK.

Ejemplos

Ejemplo 1: Actualización de SoftDeleteFeatureState de un almacén

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$props = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -SoftDeleteFeatureState Enable

El primer comando obtiene un objeto Vault y, a continuación, lo almacena en la variable $vault. El segundo comando Actualiza la propiedad SoftDeleteFeatureState del almacén al estado "Habilitado". Los valores permitidos para SoftDeleteFeatureState son Disable, Enable, AlwaysON.

Ejemplo 2: Actualización del cifrado cmK de un almacén para usar SystemAssigned MSIdentity

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName" 
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName" 
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -InfrastructureEncryption -VaultId $vault.ID -UseSystemAssignedIdentity $true

El primer cmdlet obtiene el RSVault para actualizar las propiedades de cifrado. El segundo cmdlet obtiene el almacén de claves de Azure. El tercer cmdlet obtiene la clave del almacén de claves. El cuarto cmdlet actualiza la clave de cifrado administrada por el cliente dentro del RSVault al que se va a acceder a través de la identidad SystemAssigned. Use -InfrastructureEncryption parámetro para habilitar el cifrado de infraestructura por primera vez.

Ejemplo 3: Actualización del cifrado cmK de un almacén para usar userAssigned MSIdentity

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName" 
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName" 
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -VaultId $vault.ID -UseSystemAssignedIdentity $false -UserAssignedIdentity $vault.Identity.UserAssignedIdentities.Keys[0]

El primer cmdlet obtiene el RSVault para actualizar las propiedades de cifrado. El segundo cmdlet obtiene el almacén de claves de Azure. El tercer cmdlet obtiene la clave del almacén de claves. El cuarto cmdlet actualiza la clave de cifrado administrada por el cliente dentro del RSVault al que se va a acceder a través de la identidad UserAssigned.

Ejemplo 4: Actualización de HybridBackupSecurityFeature de un almacén

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$prop = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -DisableHybridBackupSecurityFeature $false

El primer comando obtiene un objeto Vault y, a continuación, lo almacena en la variable $vault. El segundo comando deshabilita hybridBackupSecurityFeature del almacén, establezca $true para habilitarlo de nuevo.

Ejemplo 5: Actualización de SoftDeleteFeatureState y HybridBackupSecurityFeature a AlwaysON

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName" 
$prop = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -SoftDeleteFeatureState AlwaysON

El primer comando obtiene un objeto Vault y, a continuación, lo almacena en la variable $vault. El segundo comando establece SoftDeleteFeatureState del almacén en "AlwaysON", que también establecerá HybridBackupSecurityFeature en AlwaysON. Además, el parámetro SoftDeleteRetentionPeriodInDays se usa para establecer el período de retención de eliminación temporal en 16 días.

Parámetros

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableHybridBackupSecurityFeature

Marca opcional ($true/$false) para deshabilitar o habilitar la configuración de seguridad para las copias de seguridad híbridas frente a eliminaciones accidentales y agregar una capa adicional de autenticación para las operaciones críticas. Proporcione $false para habilitar la seguridad.

Tipo:Nullable<T>[Boolean]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionKeyId

KeyId de la clave de cifrado que se va a usar para CMK.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InfrastructureEncryption

Habilita el cifrado de infraestructura en este almacén. El cifrado de infraestructura debe estar habilitado al configurar el cifrado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-KeyVaultSubscriptionId

Identificador de suscripción del almacén de claves.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SoftDeleteFeatureState

SoftDeleteFeatureState del almacén de Recovery Services. Los valores permitidos son Disable, Enable, AlwaysON.

Tipo:String
Valores aceptados:Enable, Disable, AlwaysON
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SoftDeleteRetentionPeriodInDays

Especifica el período de retención para los elementos eliminados temporalmente en días.

Tipo:Nullable<T>[Int32]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Token

Token de acceso auxiliar para autenticar la operación crítica en la suscripción de Protección de recursos

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserAssignedIdentity

Id. de ARM de UserAssigned Identity que se va a usar para el cifrado de CMK. Proporcione este parámetro si UseSystemAssignedIdentity es $false.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UseSystemAssignedIdentity

Marca booleana para indicar si SystemAssigned Identity se usará para el cifrado CMK. Vaules aceptados: $true, $false

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VaultId

Id. de ARM del almacén de Recovery Services.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState

Salidas