Update-AzRecoveryServicesVault

Reference

Modul:: Az.RecoveryServices

Aktualizuje MSIdentity na trezor služby Recovery Services.

Syntaxe

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

Description

Tato rutina slouží k přidání nebo odebrání MSI z trezoru služby Recovery Services. Pomocí parametru -IdentityType přidejte do rsVault identitu SystemAssigned/UserAssigned. Pomocí přepínače RemoveSystemAssigned/RemoveUserAssigned odeberte MSI z trezoru.

Příklady

Příklad 1: Přidání identity SystemAssigned do trezoru služby Recovery Services

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

Tato rutina slouží k přidání identity SystemAssigned do trezoru služby Recovery Services.

Příklad 2: Přidání identity přiřazené uživatelem do trezoru služby 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]}

První rutina načte trezor služby Recovery Services. Druhá a třetí rutina načte uživatele vytvořené rozhraní MSI. Čtvrtá rutina přidá uživatelské rozhraní MSI do trezoru. Pátá rutina zobrazuje identity přidané do trezoru.

Příklad 3: Odebrání identit SystemAssigned a UserAssigned z trezoru

$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 :

První rutina načte trezor služby Recovery Services. Druhá rutina odebere identitu SystemAssigned z trezoru. Třetí rutina načte všechny uživatelské rozhraní MSI jako seznam z trezoru. Čtvrtá rutina odebere ze trezoru všechny uživatelské rozhraní MSI. V případě potřeby můžete zadat vybrané identity uživatelů, které se mají odebrat jako čárky oddělené jako v předchozím příkladu. Pátá rutina zobrazuje identity v trezoru, protože jsme odebrali všechny identity, typ se zobrazí jako None.

Příklad 4: Aktualizace PublicNetworkAccess, ImmutabilityState trezoru služby 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

První rutina načte trezor služby Recovery Services. Druhá rutina aktualizuje vlastnosti PublicNetworkAccess, ImmutabilityState trezoru služby Recovery Services. Třetí a čtvrtý příkaz slouží k načtení přístupu k veřejné síti a neměnnosti stavu trezoru.

Příklad 5: Povolení nebo zakázání úložiště CrossSubscriptionRestore pro trezor služby 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

První rutina načte trezor služby Recovery Services. Druhá rutina aktualizuje CrossSubscriptionRestoreState trezoru služby Recovery Services. Třetí příkaz získá stav obnovení trezoru mezi předplatnými.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CrossSubscriptionRestoreState

Stav obnovení trezoru mezi předplatnými Povolené hodnoty jsou Enabled (Povoleno), Disabled (Zakázáno), PermanentlyDisabled (Trvaledisabled).

Typ:	Nullable<T>[CrossSubscriptionRestoreState]
Přípustné hodnoty:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableAzureMonitorAlertsForJobFailure

Logický parametr určující, jestli se mají přijímat integrovaná upozornění služby Azure Monitor pro každé selhání úlohy.

Typ:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DisableClassicAlerts

Logický parametr určující, jestli mají být upozornění zálohování z klasického řešení zakázaná nebo povolená.

Typ:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IdentityId

ID ARM identity přiřazené uživatelem, které se má přidat nebo odebrat Toto je čárkami oddělený seznam ID identity.

Typ:	String[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-IdentityType

Typ MSI přiřazený k trezoru služby Recovery Services.

Typ:	MSIdentity
Přípustné hodnoty:	SystemAssigned, None, UserAssigned
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ImmutabilityState

Neměnný stav trezoru. Povolené hodnoty jsou Disabled (Zakázáno), Unlocked (Odemknuté), Locked (Uzamčeno). Odemknuté znamená povoleno a lze ho změnit, Uzamčeno znamená Povoleno a nelze ho změnit.

Typ:	Nullable<T>[ImmutabilityState]
Přípustné hodnoty:	Disabled, Unlocked, Locked
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Name

Určuje název trezoru služby Recovery Services, který se má aktualizovat.

Typ:	String
Position:	2
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PublicNetworkAccess

Parametr pro povolení nebo zakázání přístupu k veřejné síti trezoru Toto nastavení je užitečné u privátních koncových bodů.

Typ:	Nullable<T>[PublicNetworkAccess]
Přípustné hodnoty:	Enabled, Disabled
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RemoveSystemAssigned

Pokud chcete odebrat identitu SystemAssigned z trezoru, zadejte tento přepínač.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RemoveUserAssigned

Pokud chcete odebrat identitu přiřazenou uživatelem z trezoru, zadejte tento přepínač. Zadejte také parametr IdenityId spolu s tímto přepínačem.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ResourceGroupName

Určuje název skupiny prostředků Azure, ve které je k dispozici trezor služby Recovery Services.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Token

Parametr pro autorizaci operací chráněných ochranu prostředků napříč tenanty Použít příkaz (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token pro načtení autorizačního tokenu pro jiného tenanta

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

Výstupy

Vault

Sdílet prostřednictvím