Update-AzRecoveryServicesVault

Odwołanie

Moduł:: Az.RecoveryServices

Aktualizuje identyfikator MSIdentity do magazynu usługi Recovery Services.

Składnia

Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      [-IdentityId <String[]>]
      [-RemoveUserAssigned]
      [-RemoveSystemAssigned]
      [-DisableClassicAlerts <Boolean>]
      [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-ImmutabilityState <ImmutabilityState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-DefaultProfile <IAzureContextContainer>]
      [-Token <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      -IdentityType <MSIdentity>
      [-IdentityId <String[]>]
      [-DisableClassicAlerts <Boolean>]
      [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-ImmutabilityState <ImmutabilityState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-DefaultProfile <IAzureContextContainer>]
      [-Token <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

To polecenie cmdlet służy do dodawania lub usuwania tożsamości usługi zarządzanej z magazynu usługi Recovery Services. Użyj parametru -IdentityType, aby dodać tożsamość SystemAssigned/UserAssigned do programu RSVault. Użyj przełącznika RemoveSystemAssigned/RemoveUserAssigned, aby usunąć tożsamość usługi zarządzanej z magazynu.

Przykłady

Przykład 1. Dodawanie tożsamości SystemAssigned do magazynu usługi Recovery Services

Update-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName" -IdentityType SystemAssigned

To polecenie cmdlet służy do dodawania tożsamości SystemAssigned do magazynu usługi Recovery Services.

Przykład 2. Dodawanie tożsamości UserAssigned do magazynu usługi Recovery Services

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$identity1 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity1"
$identity2 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity2"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -IdentityType UserAssigned -IdentityId $identity1.Id, $identity2.Id
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type                   : UserAssigned
UserAssignedIdentities : {[/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity1,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity],
                         [/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity2,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity]}

Pierwsze polecenie cmdlet pobiera magazyn usługi Recovery Services. Drugie i trzecie polecenie cmdlet pobiera identyfikatory MSI utworzone przez użytkownika. Czwarte polecenie cmdlet dodaje interfejsy MSI użytkownika do magazynu. Piąte polecenie cmdlet pokazuje tożsamości dodane do magazynu.

Przykład 3. Usuwanie tożsamości SystemAssigned i UserAssigned z magazynu

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveSystemAssigned
$AllUserIdentities =  $vault.Identity.UserAssignedIdentities.Keys | ForEach-Object {$_} 
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveUserAssigned -IdentityId $AllUserIdentities
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               :
Type                   : None
UserAssignedIdentities :

Pierwsze polecenie cmdlet pobiera magazyn usługi Recovery Services. Drugie polecenie cmdlet usuwa tożsamość SystemAssigned z magazynu. Trzecie polecenie cmdlet pobiera wszystkie identyfikatory MSI użytkownika jako listę z magazynu. Czwarte polecenie cmdlet usuwa wszystkie interfejsy MSI użytkownika z magazynu. Jeśli chcesz, możesz podać wybrane tożsamości użytkowników, które mają zostać usunięte jako rozdzielone przecinkami, tak jak w poprzednim przykładzie. Piąte polecenie cmdlet pokazuje tożsamości w magazynie, ponieważ usunęliśmy wszystkie tożsamości, typ jest wyświetlany jako Brak.

Przykład 4. Aktualizacja funkcji PublicNetworkAccess, ImmutabilityState magazynu usługi Recovery Services

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -PublicNetworkAccess "Disabled" -ImmutabilityState "Unlocked"
$updatedVault.Properties.PublicNetworkAccess
$updatedVault.Properties.ImmutabilitySettings.ImmutabilityState

Disabled
Unlocked

Pierwsze polecenie cmdlet pobiera magazyn usługi Recovery Services. Drugie polecenie cmdlet aktualizuje właściwości PublicNetworkAccess, ImmutabilityState magazynu usługi Recovery Services. Trzecie i czwarte polecenie służy do pobierania dostępu do sieci publicznej i stanu niezmienności magazynu.

Przykład 5. Włączanie/wyłączanie funkcji CrossSubscriptionRestore dla magazynu usługi Recovery Services

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -CrossSubscriptionRestoreState Disabled
$updatedVault.Properties.RestoreSettings.CrossSubscriptionRestoreSettings.CrossSubscriptionRestoreState

Disabled

Pierwsze polecenie cmdlet pobiera magazyn usługi Recovery Services. Drugie polecenie cmdlet aktualizuje CrossSubscriptionRestoreState magazynu usługi Recovery Services. Trzecie polecenie pobiera stan przywracania między subskrypcjami magazynu.

Parametry

-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

-CrossSubscriptionRestoreState

Stan przywracania między subskrypcjami magazynu. Dozwolone wartości to "Enabled", "Disabled", "PermanentDisabled".

Typ:	Nullable<T>[CrossSubscriptionRestoreState]
Dopuszczalne wartości:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-DisableAzureMonitorAlertsForJobFailure

Parametr logiczny określający, czy wbudowane alerty usługi Azure Monitor powinny być odbierane dla każdego niepowodzenia zadania.

Typ:	Nullable<T>[Boolean]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-DisableClassicAlerts

Parametr logiczny określający, czy alerty kopii zapasowej z klasycznego rozwiązania powinny być wyłączone, czy włączone.

Typ:	Nullable<T>[Boolean]
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-IdentityId

Identyfikatory usługi ARM tożsamości UserAssigned, które mają zostać dodane/usunięte. Jest to rozdzielona przecinkami lista identyfikatorów tożsamości.

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

-IdentityType

Typ msi przypisany do magazynu usługi Recovery Services.

Typ:	MSIdentity
Dopuszczalne wartości:	SystemAssigned, None, UserAssigned
Position:	Named
Domyślna wartość:	None
Wymagane:	True
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-ImmutabilityState

Stan niezmienności magazynu. Dozwolone wartości to "Disabled", "Unlocked", "Locked". Odblokowane oznacza włączone i można je zmienić, Blokada oznacza Włączone i nie można go zmienić.

Typ:	Nullable<T>[ImmutabilityState]
Dopuszczalne wartości:	Disabled, Unlocked, Locked
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-Name

Określa nazwę magazynu usługi Recovery Services do zaktualizowania.

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

-PublicNetworkAccess

Parametr włączania/wyłączania dostępu do sieci publicznej magazynu. To ustawienie jest przydatne w przypadku prywatnych punktów końcowych.

Typ:	Nullable<T>[PublicNetworkAccess]
Dopuszczalne wartości:	Enabled, Disabled
Position:	Named
Domyślna wartość:	None
Wymagane:	False
Akceptowanie danych wejściowych potoku:	False
Akceptowanie symboli wieloznacznych:	False

-RemoveSystemAssigned

Podaj ten przełącznik, aby usunąć tożsamość SystemAssigned z magazynu.

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

-RemoveUserAssigned

Podaj ten przełącznik, aby usunąć tożsamość UserAssigned z magazynu. Ponadto podaj parametr IdenityId wraz z tym przełącznikiem.

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

-ResourceGroupName

Określa nazwę grupy zasobów platformy Azure, w której znajduje się magazyn usługi Recovery Services.

Typ:	String
Position:	1
Domyślna wartość:	None
Wymagane:	True
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-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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

String

Dane wyjściowe

Vault

Udostępnij za pośrednictwem