Lezen in het Engels

Delen via

Update-AzDataProtectionBackupVault

  • Referentie
Module:
Az.DataProtection

Hiermee werkt u een BackupVault-resource bij die hoort bij een resourcegroep. Bijvoorbeeld het bijwerken van tags voor een resource.

Syntaxis

Update-AzDataProtectionBackupVault
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      -ResourceGroupName <String>
      -VaultName <String>
      [-SubscriptionId <String>]
      [-CmkEncryptionState <EncryptionState>]
      [-CmkIdentityType <IdentityType>]
      [-CmkUserAssignedIdentityId <String>]
      [-CmkEncryptionKeyUri <String>]
      [-SecureToken <SecureString>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzDataProtectionBackupVault
      -InputObject <IDataProtectionIdentity>
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-EncryptionSetting <IEncryptionSettings>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Hiermee werkt u een BackupVault-resource bij die hoort bij een resourcegroep. Bijvoorbeeld het bijwerken van tags voor een resource.

Voorbeelden

Voorbeeld 1: Tags toevoegen aan een bestaande back-upkluis

$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

Met de eerste opdracht maakt u een nieuwe tag-hashtabel met tags en de bijbehorende waarden. Met de tweede opdracht worden de opgegeven tags toegevoegd aan de back-upkluis.

Voorbeeld 2: Azure Monitor-waarschuwingen uitschakelen voor taakfouten

Update-AzDataProtectionBackupVault -ResourceGroupName "rgName" -VaultName "vaultName" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -AzureMonitorAlertsForAllJobFailure 'Disabled'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Met deze opdracht worden de monitorwaarschuwingen uitgeschakeld voor alle taakfouten voor de back-upkluis. Toegestane waarden zijn: Ingeschakeld, Uitgeschakeld. Houd er rekening mee dat deze instelling standaard is ingeschakeld.

Voorbeeld 3: Kluis ImmutabilityState, CrossSubscriptionRestoreState, instellingen voor voorlopig verwijderen bijwerken

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

Deze opdracht wordt gebruikt voor het wijzigen van de status Onveranderbaarheid, herstelstatus voor meerdere abonnementen, instellingen voor voorlopig verwijderen van de kluis. Deze parameters zijn optioneel en kunnen onafhankelijk worden gebruikt.

Voorbeeld 4: Kluis CmkIdentityType bijwerken van UserAssignedManagedIdentity naar SystemAssignedManagedIdentity en 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

Deze opdracht wordt gebruikt om CmkIdentityType en CmkEncryptionKeyUri te wijzigen. Deze parameters zijn optioneel en kunnen onafhankelijk worden gebruikt.

Voorbeeld 5: Kluis CmkIdentityType bijwerken van SystemAssignedManagedIdentity naar 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

Deze opdracht wordt gebruikt om CmkIdentityType te wijzigen van SystemAssigned in UserAssgined. CmkIdenityId is een vereiste parameter.

Voorbeeld 6: Een kluis bijwerken om een door de gebruiker toegewezen beheerde identiteit (UAMI) toe te wijzen

$UAMI = @{"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userAssignedIdentityName"=[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api40.UserAssignedIdentity]::new()}

$vault = Update-AzDataProtectionBackupVault -AssignUserIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName" -IdentityType 'SystemAssigned,UserAssigned'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned, UserAssigned

Maak eerst een hashtabel voor het UAMI-object (User Assigned Managed Identity). Dit object wijst de UAMI-resource-id toe aan een nieuw exemplaar van UserAssignedIdentity. Gebruik vervolgens de cmdlet Update-AzDataProtectionBackupVault om de UAMI toe te wijzen aan de back-upkluis terwijl de door het systeem toegewezen beheerde identiteit behouden blijft. De parameter -IdentityType geeft aan dat zowel SystemAssigned- als UserAssigned-identiteiten worden gebruikt.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AzureMonitorAlertsForAllJobFailure

Parameter voor het in- of uitschakelen van ingebouwde Azure Monitor-waarschuwingen voor taakfouten. Beveiligingswaarschuwingen kunnen niet worden uitgeschakeld.

Type:AlertsState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CmkEncryptionKeyUri

De sleutel-URI van de CMK-sleutel die moet worden gebruikt voor versleuteling. Als u automatische rotatie van sleutels wilt inschakelen, sluit u het versieonderdeel uit van de sleutel-URI.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CmkEncryptionState

Schakel de CMK-versleutelingsstatus in voor een Backup Vault.

Type:EncryptionState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CmkIdentityType

Het identiteitstype dat moet worden gebruikt voor CMK-versleuteling - SystemAssigned of UserAssigned Identity.

Type:IdentityType
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CmkUserAssignedIdentityId

Deze parameter is vereist als het identiteitstype UserAssigned is. Voeg de door de gebruiker toegewezen beheerde identiteit-id toe die moet worden gebruikt met toegangsmachtigingen voor de Key Vault.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CrossRegionRestoreState

Herstelstatus tussen regio's van de kluis. Toegestane waarden zijn uitgeschakeld, ingeschakeld.

Type:CrossRegionRestoreState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CrossSubscriptionRestoreState

Herstelstatus van de kluis tussen abonnementen. Toegestane waarden zijn uitgeschakeld, ingeschakeld, permanentdisabled.

Type:CrossSubscriptionRestoreState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EncryptionSetting

Door de klant beheerde sleuteldetails van de resource. Zie de sectie NOTES voor de eigenschappen ENCRYPTIONSETTING en maak een hash-tabel om deze samen te stellen.

Type:IEncryptionSettings
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdentityType

Het identityType dat systemAssigned, UserAssigned, SystemAssigned, UserAssigned of None kan zijn

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdentityUserAssignedIdentity

Hiermee haalt u de door de gebruiker toegewezen identiteiten op of stelt u deze in.

Type:Hashtable
Aliassen:UserAssignedIdentity, AssignUserIdentity
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ImmutabilityState

Onveranderbaarheidsstatus van de kluis. Toegestane waarden zijn uitgeschakeld, ontgrendeld, vergrendeld.

Type:ImmutabilityState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Identity Parameter To construct, zie DE SECTIE NOTES voor INPUTOBJECT-eigenschappen en maak een hash-tabel.

Type:IDataProtectionIdentity
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoWait

De opdracht asynchroon uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGuardOperationRequest

ResourceGuardOperationRequests waarop lac-controle wordt uitgevoerd

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SecureToken

Parameter voor het autoriseren van bewerkingen die worden beveiligd door resourcebeveiliging voor meerdere tenants. Gebruik de opdracht (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString"). Token voor het ophalen van autorisatietoken voor verschillende tenants.

Type:SecureString
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SoftDeleteRetentionDurationInDay

Bewaarduur voor voorlopig verwijderen in dagen.

Type:Double
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SoftDeleteState

Status van voorlopig verwijderen van de kluis. Toegestane waarden zijn uitgeschakeld, Aan, AlwaysOn.

Type:SoftDeleteState
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubscriptionId

De id van het doelabonnement. De waarde moet een UUID zijn.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Tag

Resourcetags.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Token

Parameter voor het autoriseren van bewerkingen die worden beveiligd door resourcebeveiliging voor meerdere tenants. Gebruik de opdracht (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token voor het ophalen van autorisatietoken voor verschillende tenants.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VaultName

De naam van de back-upkluis.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

IDataProtectionIdentity

Uitvoerwaarden

IBackupVaultResource