Update-AzDataProtectionBackupVault

Odwołanie

Moduł:: Az.DataProtection

Aktualizuje zasób BackupVault należący do grupy zasobów. Na przykład aktualizowanie tagów zasobu.

Składnia

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>]

Opis

Aktualizuje zasób BackupVault należący do grupy zasobów. Na przykład aktualizowanie tagów zasobu.

Przykłady

Przykład 1. Dodawanie tagów do istniejącego magazynu kopii zapasowych

$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

Pierwsze polecenie tworzy nową tabelę skrótów tagów z tagami i ich wartościami. Drugie polecenie dodaje podane tagi do magazynu kopii zapasowych.

Przykład 2. Wyłączanie alertów usługi Azure Monitor dla niepowodzeń zadań

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

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

To polecenie wyłącza alerty monitorowania dla wszystkich niepowodzeń zadań dla magazynu kopii zapasowych. Dozwolone wartości to: Włączone, Wyłączone. Należy pamiętać, że to ustawienie jest domyślnie włączone.

Przykład 3: Aktualizowanie stanu Niezmienności magazynu, CrossSubscriptionRestoreState, ustawień usuwania nietrwałego

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

To polecenie służy do modyfikowania stanu niezmienności, stanu przywracania między subskrypcjami, ustawień usuwania nietrwałego magazynu. Te parametry są opcjonalne i mogą być używane niezależnie.

Przykład 4: Aktualizowanie magazynu CmkIdentityType z elementu UserAssignedManagedIdentity do elementu SystemAssignedManagedIdentity i 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

To polecenie służy do modyfikowania atrybutów CmkIdentityType i CmkEncryptionKeyUri. Te parametry są opcjonalne i mogą być używane niezależnie.

Przykład 5. Aktualizacja właściwości CmkIdentityType magazynu z elementu SystemAssignedManagedIdentity na 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

To polecenie służy do zmiany właściwości CmkIdentityType z elementu SystemAssigned na UserAssgined. CmkIdenityId jest wymaganym parametrem.

Przykład 6. Aktualizowanie magazynu w celu przypisania tożsamości zarządzanej przypisanej przez użytkownika (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

Najpierw utwórz tabelę skrótu dla obiektu Tożsamość zarządzana przypisana przez użytkownika (UAMI). Ten obiekt mapuje identyfikator zasobu UAMI na nowe wystąpienie atrybutu UserAssignedIdentity. Następnie użyj polecenia cmdlet Update-AzDataProtectionBackupVault, aby przypisać element UAMI do magazynu kopii zapasowych przy zachowaniu tożsamości zarządzanej przypisanej przez system. Parametr -IdentityType określa, że są używane tożsamości SystemAssigned i UserAssigned.

Parametry

-AsJob

Uruchamianie polecenia jako zadania

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-AzureMonitorAlertsForAllJobFailure

Parametr włączania lub wyłączania wbudowanych alertów usługi Azure Monitor dla niepowodzeń zadań. Nie można wyłączyć alertów zabezpieczeń.

Typ:	AlertsState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CmkEncryptionKeyUri

Identyfikator URI klucza klucza zarządzania kluczem do użycia na potrzeby szyfrowania. Aby włączyć automatyczne obracanie kluczy, wyklucz składnik wersji z identyfikatora URI klucza.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CmkEncryptionState

Włącz stan szyfrowania cmK dla magazynu kopii zapasowych.

Typ:	EncryptionState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CmkIdentityType

Typ tożsamości, który ma być używany do szyfrowania cmK — SystemAssigned lub UserAssigned Identity.

Typ:	IdentityType
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CmkUserAssignedIdentityId

Ten parametr jest wymagany, jeśli typ tożsamości to UserAssigned. Dodaj identyfikator tożsamości zarządzanej przypisanej przez użytkownika, który ma uprawnienia dostępu do usługi Key Vault.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CrossRegionRestoreState

Stan przywracania między regionami magazynu. Dozwolone wartości to Wyłączone, Włączone.

Typ:	CrossRegionRestoreState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-CrossSubscriptionRestoreState

Stan przywracania między subskrypcjami magazynu. Dozwolone wartości to Wyłączone, Włączone, TrwałeDisabled.

Typ:	CrossSubscriptionRestoreState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Typ:	PSObject
Aliasy:	AzureRMContext, AzureCredential
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-EncryptionSetting

Szczegóły klucza zarządzanego przez klienta dotyczące zasobu. Aby utworzyć tabelę, zobacz sekcję UWAGI dla właściwości ENCRYPTIONSETTING i utwórz tabelę skrótów.

Typ:	IEncryptionSettings
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IdentityType

Typ tożsamości, który może mieć wartość SystemAssigned, UserAssigned, "SystemAssigned,UserAssigned" lub None

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IdentityUserAssignedIdentity

Pobiera lub ustawia tożsamości przypisane przez użytkownika.

Typ:	Hashtable
Aliasy:	UserAssignedIdentity, AssignUserIdentity
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ImmutabilityState

Stan niezmienności magazynu. Dozwolone wartości to Wyłączone, Odblokowane, Zablokowane.

Typ:	ImmutabilityState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-InputObject

Parametr tożsamości Do konstruowania, zobacz sekcję UWAGI dla właściwości INPUTOBJECT i utwórz tabelę skrótów.

Typ:	IDataProtectionIdentity
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	True
Akceptowanie symboli wieloznacznych:	False

-NoWait

Uruchom polecenie asynchronicznie

Typ:	SwitchParameter
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceGroupName

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ResourceGuardOperationRequest

ResourceGuardOperationRequests, na którym zostanie wykonane sprawdzanie LAC

Typ:	String[]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SecureToken

Parametr umożliwiający autoryzację operacji chronionych przez funkcję ochrony zasobów między dzierżawami. Użyj polecenia (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx -AsSecureString"). Token do pobierania tokenu autoryzacji dla innej dzierżawy.

Typ:	SecureString
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SoftDeleteRetentionDurationInDay

Czas przechowywania usuwania nietrwałego w dniach.

Typ:	Double
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SoftDeleteState

Stan usuwania nietrwałego magazynu. Dozwolone wartości to Off, On, AlwaysOn.

Typ:	SoftDeleteState
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-SubscriptionId

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Tag

Tagi zasobów.

Typ:	Hashtable
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Token

Parametr umożliwiający autoryzację operacji chronionych przez funkcję ochrony zasobów między dzierżawami. Użyj polecenia (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token do pobierania tokenu autoryzacji dla innej dzierżawy.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-VaultName

Nazwa magazynu kopii zapasowych.

Typ:	String
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

Dane wejściowe

IDataProtectionIdentity

Dane wyjściowe

IBackupVaultResource

Udostępnij za pośrednictwem