Update-AzDataProtectionBackupVault

Referens

Modul:: Az.DataProtection

Uppdaterar en BackupVault-resurs som tillhör en resursgrupp. Till exempel uppdatering av taggar för en resurs.

Syntax

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

Uppdaterar en BackupVault-resurs som tillhör en resursgrupp. Till exempel uppdatering av taggar för en resurs.

Exempel

Exempel 1: Lägga till taggar i ett befintligt säkerhetskopieringsvalv

$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

Det första kommandot skapar en ny tagg-hashtable med taggar och deras värden. Det andra kommandot lägger till de angivna taggarna i säkerhetskopieringsvalvet.

Exempel 2: Inaktivera Azure Monitor-aviseringar för jobbfel

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

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

Det här kommandot inaktiverar övervakningsaviseringar för alla jobbfel för säkerhetskopieringsvalvet. Tillåtna värden är: Aktiverad, Inaktiverad. Observera att den här inställningen är aktiverad som standard.

Exempel 3: Uppdatera valvet ImmutabilityState, CrossSubscriptionRestoreState, inställningar för mjuk borttagning

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

Det här kommandot används för att ändra oföränderlighetstillstånd, återställningstillstånd för flera prenumerationer, inställningar för mjuk borttagning av valvet. Dessa parametrar är valfria och kan användas oberoende av varandra.

Exempel 4: Uppdatera valvet CmkIdentityType från UserAssignedManagedIdentity till SystemAssignedManagedIdentity och 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

Det här kommandot används för att ändra CmkIdentityType och CmkEncryptionKeyUri. Dessa parametrar är valfria och kan användas oberoende av varandra.

Exempel 5: Uppdatera valvet CmkIdentityType från SystemAssignedManagedIdentity till 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

Det här kommandot används för att ändra CmkIdentityType från SystemAssigned till UserAssgined. CmkIdenityId är en obligatorisk parameter.

Exempel 6: Uppdatera valvet för att tilldela en användartilldelad hanterad identitet (UAMI)

$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

Skapa först en hashtable för UAMI-objektet (User Assigned Managed Identity). Det här objektet mappar UAMI-resurs-ID:t till en ny instans av UserAssignedIdentity. Använd sedan cmdleten Update-AzDataProtectionBackupVault för att tilldela UAMI till säkerhetskopieringsvalvet samtidigt som du behåller den systemtilldelade hanterade identiteten. Parametern -IdentityType anger att både SystemAssigned och UserAssigned identities används.

Parametrar

-AsJob

Kör kommandot som ett jobb

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-AzureMonitorAlertsForAllJobFailure

Parameter för att aktivera eller inaktivera inbyggda Azure Monitor-aviseringar för jobbfel. Säkerhetsaviseringar kan inte inaktiveras.

Typ:	AlertsState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CmkEncryptionKeyUri

Nyckel-URI:n för CMK-nyckeln som ska användas för kryptering. Om du vill aktivera automatisk rotation av nycklar undantar du versionskomponenten från nyckel-URI:n.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CmkEncryptionState

Aktivera CMK-krypteringstillstånd för ett Säkerhetskopieringsvalv.

Typ:	EncryptionState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CmkIdentityType

Den identitetstyp som ska användas för CMK-kryptering – SystemAssigned eller UserAssigned Identity.

Typ:	IdentityType
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CmkUserAssignedIdentityId

Den här parametern krävs om identitetstypen är UserAssigned. Lägg till det användartilldelade hanterade identitets-ID som ska användas som har åtkomstbehörighet till Key Vault.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CrossRegionRestoreState

Återställningstillstånd för valvet mellan regioner. Tillåtna värden är Inaktiverade, Aktiverade.

Typ:	CrossRegionRestoreState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CrossSubscriptionRestoreState

Återställningstillstånd för flera prenumerationer för valvet. Tillåtna värden är Inaktiverade, Aktiverade, PermanentDisabled.

Typ:	CrossSubscriptionRestoreState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:	PSObject
Alias:	AzureRMContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-EncryptionSetting

Kundhanterad nyckelinformation om resursen. Information om hur du skapar finns i AVSNITTET ANTECKNINGAR för ENCRYPTIONSETTING-egenskaper och skapa en hash-tabell.

Typ:	IEncryptionSettings
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-IdentityType

IdentityType som kan antingen vara SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" eller None

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-IdentityUserAssignedIdentity

Hämtar eller anger användartilldelade identiteter.

Typ:	Hashtable
Alias:	UserAssignedIdentity, AssignUserIdentity
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ImmutabilityState

Valvets oföränderlighetstillstånd. Tillåtna värden är Inaktiverade, Upplåst, Låst.

Typ:	ImmutabilityState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

Identitetsparameter För att skapa, se AVSNITTET ANTECKNINGAR för INPUTOBJECT-egenskaper och skapa en hash-tabell.

Typ:	IDataProtectionIdentity
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-NoWait

Kör kommandot asynkront

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGroupName

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ResourceGuardOperationRequest

ResourceGuardOperationRequests som LAC-kontrollen ska utföras på

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SecureToken

Parameter för att auktorisera åtgärder som skyddas av resursskydd mellan klientorganisationer. Använd kommandot (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxx -AsSecureString"). Token för att hämta auktoriseringstoken för en annan klientorganisation.

Typ:	SecureString
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SoftDeleteRetentionDurationInDay

Varaktighet för kvarhållning av mjuk borttagning i dagar.

Typ:	Double
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SoftDeleteState

Mjukt borttagningstillstånd för valvet. Tillåtna värden är Av, På, AlwaysOn.

Typ:	SoftDeleteState
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SubscriptionId

ID för målprenumerationen. Värdet måste vara ett UUID.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Tag

Resurstaggar.

Typ:	Hashtable
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Token

Parametern är inaktuell. Använd SecureToken i stället.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-VaultName

Namnet på säkerhetskopieringsvalvet.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

IDataProtectionIdentity

Utdata

IBackupVaultResource

Dela via