Update-AzDataProtectionBackupVault
Atualize um recurso BackupVault pertencente a um grupo de recursos.
Sintaxe
UpdateExpanded (Predefinição)
Update-AzDataProtectionBackupVault
-ResourceGroupName <String>
-VaultName <String>
[-Token <String>]
[-AzureMonitorAlertsForAllJobFailure <String>]
[-CrossRegionRestoreState <String>]
[-CrossSubscriptionRestoreState <String>]
[-EnableSystemAssignedIdentity <Boolean>]
[-ImmutabilityState <String>]
[-ResourceGuardOperationRequest <String[]>]
[-SoftDeleteRetentionDurationInDay <Double>]
[-SoftDeleteState <String>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-SubscriptionId <String>]
[-CostManagementGranularity <String>]
[-CmkEncryptionState <String>]
[-CmkIdentityType <String>]
[-CmkUserAssignedIdentityId <String>]
[-CmkEncryptionKeyUri <String>]
[-SecureToken <SecureString>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
Update-AzDataProtectionBackupVault
-InputObject <IDataProtectionIdentity>
[-Token <String>]
[-XmsDeletedVaultId <String>]
[-AzureMonitorAlertsForAllJobFailure <String>]
[-CostManagementSettingGranularityLevel <String>]
[-CrossRegionRestoreState <String>]
[-CrossSubscriptionRestoreState <String>]
[-ETag <String>]
[-EnableSystemAssignedIdentity <Boolean>]
[-EncryptionSetting <IEncryptionSettings>]
[-ImmutabilityState <String>]
[-ReplicatedRegion <String[]>]
[-ResourceGuardOperationRequest <String[]>]
[-SoftDeleteRetentionDurationInDay <Double>]
[-SoftDeleteState <String>]
[-StorageSetting <IStorageSetting[]>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
Atualize um recurso BackupVault pertencente a um grupo de recursos.
Exemplos
$tag = @{"Owner"="sarath";"Purpose"="AzureBackupTesting"}
Update-AzDataProtectionBackupVault -SubscriptionId "xxx-xxx-xxx" -ResourceGroupName sarath-rg -VaultName sarath-vault -Tag $tag
ETag IdentityPrincipalId IdentityTenantId IdentityType Location Name Type
---- ------------------- ---------------- ------------ -------- ---- ----
2ca1d5f7-38b3-4b61-aa45-8147d7e0edbc 72f988bf-86f1-41af-91ab-2d7cd011db47 SystemAssigned centraluseuap sarath-vault Microsoft.DataProtection/backupVaults
O primeiro comando cria uma nova hashtable de tags com tags e seus valores.
O segundo comando adiciona as tags fornecidas ao cofre de backup.
Exemplo 2: Desativar alertas de monitorização do Azure para falhas de trabalho
Update-AzDataProtectionBackupVault -ResourceGroupName "rgName" -VaultName "vaultName" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -AzureMonitorAlertsForAllJobFailure 'Disabled'
Name Location Type IdentityType
---- -------- ---- ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned
Este comando desativa os alertas do monitor para todas as falhas de trabalho para o cofre de backup.
Os valores permitidos são: Habilitado, Desabilitado.
Observe que, por padrão, essa configuração está habilitada.
Exemplo 3: Atualizar configurações de ImmutabilityState do cofre, CrossSubscriptionRestoreState, soft delete
Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CrossSubscriptionRestoreState Disabled -ImmutabilityState Disabled -SoftDeleteRetentionDurationInDay 99 -SoftDeleteState Off
Name Location Type IdentityType
---- -------- ---- ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned
Este comando é usado para modificar o estado de imutabilidade, o estado de restauração entre assinaturas, as configurações de exclusão suave do cofre.
Estes parâmetros são opcionais e podem ser utilizados de forma independente.
Exemplo 4: Atualizar CmkIdentityType do cofre de UserAssignedManagedIdentity para SystemAssignedManagedIdentity e CmkEncryptionKeyUri
$cmkKeyUri = "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1"
Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType SystemAssigned -CmkEncryptionKeyUri $cmkKeyUri
Name Location Type IdentityType
---- -------- ---- ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned
Este comando é usado para modificar CmkIdentityType e CmkEncryptionKeyUri.
Estes parâmetros são opcionais e podem ser utilizados de forma independente.
Exemplo 5: Atualizar CmkIdentityType do cofre de SystemAssignedManagedIdentity para UserAssignedManagedIdentity
$cmkIdentityId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"
Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType UserAssigned -CmkUserAssignedIdentityId $cmkIdentityId
Name Location Type IdentityType
---- -------- ---- ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults UserAssigned
Este comando é usado para alterar CmkIdentityType de SystemAssigned para UserAssgined.
CmkIdenityId é um parâmetro obrigatório.
Exemplo 6: Atualizar o cofre para atribuir uma Identidade Gerenciada Atribuída ao Usuário (UAMI)
$UAMI = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userAssignedIdentityName"
$vault = Update-AzDataProtectionBackupVault -EnableSystemAssignedIdentity -UserAssignedIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName"
Name Location Type IdentityType
---- -------- ---- ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned, UserAssigned
Primeiro, defina o ID do recurso ARM da Identidade Gerida Atribuída pelo Utilizador (UAMI).
Em seguida, use o cmdlet Update-AzDataProtectionBackupVault para atribuir o UAMI ao cofre de backup, mantendo a Identidade Gerenciada Atribuída pelo Sistema.
O comutador -EnableSystemAssignedIdentity ativa a identidade atribuída pelo sistema, e o parâmetro -UserAssignedIdentity especifica a identidade atribuída pelo utilizador a associar ao cofre.
Parâmetros
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-AzureMonitorAlertsForAllJobFailure
Parâmetro para habilitar ou desabilitar alertas internos do azure monitor para falhas de trabalho.
Os alertas de segurança não podem ser desativados.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CmkEncryptionKeyUri
O URI da chave CMK a ser usado para criptografia.
Para habilitar a rotação automática de chaves, exclua o componente versão do URI de chave.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CmkEncryptionState
Habilite o estado de criptografia CMK para um Cofre de Backup.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CmkIdentityType
O tipo de identidade a ser usado para criptografia CMK - SystemAssigned ou UserAssigned Identity.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CmkUserAssignedIdentityId
Este parâmetro é necessário se o tipo de identidade for UserAssigned.
Adicione o ID de identidade gerida atribuído pelo utilizador a ser usado, que tem permissões de acesso ao Key Vault.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CostManagementGranularity
Gestão de Custos Granularidade do cofre.
Os valores permitidos são VaultLevel, ProtectedItemLevel, ProtectedItemWithParentTag.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CostManagementSettingGranularityLevel
Definições para o nível de granularidade
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CrossRegionRestoreState
Estado de restauração entre regiões do cofre.
Os valores permitidos são Disabled, Enabled.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-CrossSubscriptionRestoreState
Estado de restauração de assinatura cruzada do cofre.
Os valores permitidos são Disabled, Enabled, PermanentlyDisabled.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-EnableSystemAssignedIdentity
Determina se uma identidade atribuída pelo sistema deve ser habilitada para o recurso.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Boolean ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-EncryptionSetting
Gerenciados pelo cliente Principais detalhes do recurso.
Propriedades dos parâmetros
Tipo: IEncryptionSettings
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ETag
ETag opcional.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ImmutabilityState
Estado de imutabilidade do cofre.
Os valores permitidos são Desativado, Desbloqueado, Bloqueado.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
Parâmetro de identidade
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ReplicatedRegion
Lista de regiões replicadas para o Backup Vault
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não faz distinção entre maiúsculas e minúsculas.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ResourceGuardOperationRequest
Pedido de operação de proteção de recursos num formato semelhante ao <ResourceGuard-ARMID>/<operation>/default.
Use este parâmetro quando a operação estiver protegida por MUA.
As operações suportadas incluem dppReduceImmutabilityStateRequests, dppReduceSoftDeleteSecurityRequests e dppModifyEncryptionSettingsRequests.
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SecureToken
Parâmetro para autorizar operações protegidas pelo protetor de recursos entre locatários.
Use o comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString"). Token para buscar token de autorização para locatário diferente.
Propriedades dos parâmetros
Tipo: SecureString
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SoftDeleteRetentionDurationInDay
Duração de retenção de exclusão suave em dias.
Propriedades dos parâmetros
Tipo: Double
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SoftDeleteState
Estado de exclusão suave do cofre.
Os valores permitidos são Off, On, AlwaysOn.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-StorageSetting
Configurações de armazenamento
Propriedades dos parâmetros
Tipo: IStorageSetting [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SubscriptionId
O ID da assinatura de destino.
O valor deve ser um UUID.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Tag
Tags de recursos.
Propriedades dos parâmetros
Tipo: Hashtable
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Token
Parâmetro depreciar.
Em vez disso, use o SecureToken.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-UserAssignedIdentity
A matriz de identidades atribuídas pelo usuário associadas ao recurso.
Os elementos no array serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VaultName
O nome do cofre de backup.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-XmsDeletedVaultId
A ID do cofre de backup excluído a ser restaurado durante o fluxo de undelete.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas