Compartir a través de

Update-AzDataProtectionBackupInstance

  • Referencia
Módulo:
Az.DataProtection

Actualiza una instancia de copia de seguridad determinada.

Sintaxis

Update-AzDataProtectionBackupInstance
      -ResourceGroupName <String>
      -VaultName <String>
      -BackupInstanceName <String>
      [-SubscriptionId <String>]
      [-PolicyId <String>]
      [-UseSystemAssignedIdentity <Boolean>]
      [-UserAssignedIdentityArmId <String>]
      [-VaultedBackupContainer <String[]>]
      [-ResourceGuardOperationRequest <String[]>]
      [-Token <String>]
      [-SecureToken <SecureString>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Actualiza una instancia de copia de seguridad determinada.

Ejemplos

Ejemplo 1: Actualización de la directiva y la lista de contenedores de la instancia de copia de seguridad de blobs

$instance = Search-AzDataProtectionBackupInstanceInAzGraph -Subscription $subscriptionId -ResourceGroup $resourceGroupName -Vault $vaultName -DatasourceType AzureBlob
$updatePolicy = Get-AzDataProtectionBackupPolicy -SubscriptionId $subscriptionId -VaultName $vaultName -ResourceGroupName $resourceGroupName| Where-Object { $_.name -eq "vaulted-policy" }
$backedUpContainers = $instance.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList
$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName $resourceGroupName -VaultName $vaultName -BackupInstanceName $instance.Name -SubscriptionId $subscriptionId -PolicyId $updatePolicy.Id -VaultedBackupContainer $backedUpContainers[0,2,4]
$updateBI.Property.PolicyInfo.PolicyId
$updateBI.Property.PolicyInfo.PolicyParameter.BackupDatasourceParametersList[0].ContainersList

/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/rgName/providers/Microsoft.DataProtection/backupVaults/vaultName/backupPolicies/vaulted-policy
updatedContainer1
updatedContainer2
updatedContainer3

El primer comando captura la instancia de copia de seguridad que debe actualizarse. El segundo comando obtiene la directiva de copia de seguridad con el nombre vaulted-policy que debe actualizarse en La instancia de copia de seguridad. El tercer comando captura la lista de contenedores con almacenes de los que se realiza una copia de seguridad actualmente en el almacén de copia de seguridad. Cuarto comando actualiza la instancia de copia de seguridad con una nueva directiva y una nueva lista de contenedores (que actualmente es un subconjunto de los contenedores de copia de seguridad existentes). Quinto y sexto comando muestra la lista de contenedores y directivas actualizadas en la instancia de backu.

Ejemplo 2: Actualización de UAMI en la instancia de copia de seguridad

$bi = Get-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

$updateBI = Update-AzDataProtectionBackupInstance -ResourceGroupName "myResourceGroup" -VaultName "myBackupVault" -BackupInstanceName $bi.Name -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -UserAssignedIdentityArmId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myUami" -UseSystemAssignedIdentity $false

Name                                                   BackupInstanceName
----                                                   ------------------
psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027 psDiskBI-psDiskBI-81234567-6171-4d88-ada3-ec1fc5e6c027

El primer comando captura la instancia de copia de seguridad que debe actualizarse. El segundo comando actualiza la instancia de copia de seguridad con la nueva identidad administrada asignada por el usuario (UAMI) y deshabilita el uso de identidad asignada por el sistema.

Parámetros

-AsJob

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

-BackupInstanceName

Nombre único de la instancia de copia de seguridad protegida

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

-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

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

-NoWait

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

-PolicyId

Identificador de la directiva que se va a asociar a la instancia de copia de seguridad

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

-ResourceGroupName

Grupo de recursos del almacén de copia de seguridad

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

-ResourceGuardOperationRequest

Solicitud de operación de protección de recursos con el formato similar a <ResourceGuard-ARMID>/dppModifyPolicy/default. Use este parámetro cuando la operación esté protegida por MUA.

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

-SecureToken

Parámetro para autorizar las operaciones protegidas por protección de recursos entre inquilinos. Use el comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString"). Token para capturar el token de autorización para otro inquilino.

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

-SubscriptionId

Identificador de suscripción del almacén

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

-Token

Parámetro para autorizar las operaciones protegidas por protección de recursos entre inquilinos. Use el comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString"). Token para capturar el token de autorización seguro para un inquilino diferente y, a continuación, convertir en cadena mediante ConvertFrom-SecureString cmdlet.

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

-UserAssignedIdentityArmId

Identificador de ARM de identidad asignada por el usuario

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

-UseSystemAssignedIdentity

Uso de la identidad asignada por el sistema

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

-VaultedBackupContainer

Lista de contenedores de los que se va a realizar una copia de seguridad dentro de VaultStore. Use este parámetro para DatasourceType AzureBlob.

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

-VaultName

Nombre del almacén de copia de seguridad

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

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no 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

Salidas

IBackupInstanceResource