Update-AzDataProtectionBackupVault

Module:: Az.DataProtection Module

Werk een BackupVault-resource bij die hoort bij een resourcegroep.

Syntax

UpdateExpanded (Standaard)

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>]
    [-CmkEncryptionState <String>]
    [-CmkIdentityType <String>]
    [-CmkUserAssignedIdentityId <String>]
    [-CmkEncryptionKeyUri <String>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-AzDataProtectionBackupVault
    -InputObject <IDataProtectionIdentity>
    [-Token <String>]
    [-XmsDeletedVaultId <String>]
    [-AzureMonitorAlertsForAllJobFailure <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>]

Description

Werk een BackupVault-resource bij die hoort bij een resourcegroep.

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: Waarschuwingen voor taakfouten uitschakelen Azure controleren

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"

$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

Definieer eerst de ARM-resource-id (Door de gebruiker toegewezen beheerde identiteit) (UAMI). 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 -EnableSystemAssignedIdentity-switch schakelt de door het systeem toegewezen identiteit in en de parameter -UserAssignedIdentity geeft de door de gebruiker toegewezen identiteit op die aan de kluis moet worden gekoppeld.

Parameters

-AsJob

De opdracht uitvoeren als een taak

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-AzureMonitorAlertsForAllJobFailure

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-CmkEncryptionState

Schakel de CMK-versleutelingsstatus in voor een Backup Vault.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-CmkIdentityType

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Cf

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-CrossRegionRestoreState

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-CrossSubscriptionRestoreState

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-DefaultProfile

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

Parametereigenschappen

Type:	PSObject
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	AzureRMContext, AzureCredential

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-EnableSystemAssignedIdentity

Bepaalt of een door het systeem toegewezen identiteit voor de resource moet worden ingeschakeld.

Parametereigenschappen

Type:	Nullable<T>[Boolean]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-EncryptionSetting

Door de klant beheerde sleuteldetails van de resource.

Parametereigenschappen

Type:	IEncryptionSettings
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ETag

Optionele ETag.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ImmutabilityState

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-InputObject

Identiteitsparameter

Parametereigenschappen

Type:	IDataProtectionIdentity
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	True
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-NoWait

De opdracht asynchroon uitvoeren

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ReplicatedRegion

Lijst met gerepliceerde regio's voor Backup Vault

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ResourceGroupName

De naam van de resource group. De naam is hoofdletterongevoelig.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-ResourceGuardOperationRequest

Resource Guard-bewerkingsaanvraag in de indeling die vergelijkbaar is met <ResourceGuard-ARMID>/<bewerking>/standaard. Gebruik deze parameter wanneer de bewerking MUA-beveiliging heeft. Ondersteunde bewerkingen zijn dppReduceImmutabilityStateRequests, dppReduceSoftDeleteSecurityRequests en dppModifyEncryptionSettingsRequests.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	SecureString
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-SoftDeleteRetentionDurationInDay

Bewaarduur voor voorlopig verwijderen in dagen.

Parametereigenschappen

Type:	Double
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-SoftDeleteState

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-StorageSetting

Opslaginstellingen

Parametereigenschappen

Type:	IStorageSetting[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-SubscriptionId

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Tag

Resourcetags.

Parametereigenschappen

Type:	Hashtable
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Token

Parameter wordt afgeschaft. Gebruik in plaats daarvan SecureToken.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-UserAssignedIdentity

De matrix van door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De elementen in matrix zijn ARM-resource-id's in de vorm: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-VaultName

De naam van de backupkluis.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateExpanded

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-WhatIf

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

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Wi

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-XmsDeletedVaultId

De id van de verwijderde back-upkluis waaruit moet worden hersteld tijdens het ongedaan maken van de verwijdering.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

UpdateViaIdentityExpanded

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.