Update-AzRecoveryServicesVault

Referencia

Modul:: Az.RecoveryServices

Frissítések a helyreállítási tár MSIdentitását.

Syntax

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

Description

Ezzel a parancsmaggal adhatja hozzá vagy távolíthatja el az MSI-t a helyreállítási tárból. A -IdentityType paraméterrel systemAssigned/UserAssigned identitást adhat hozzá az RSVaulthoz. A RemoveSystemAssigned/RemoveUserAssigned kapcsolóval távolítsa el az MSI-t a tárolóból.

Példák

1. példa: SystemAssigned identitás hozzáadása a helyreállítási tárhoz

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

Ezzel a parancsmaggal SystemAssigned identitást adhat hozzá egy helyreállítási tárhoz.

2. példa: UserAssigned identitás hozzáadása a helyreállítási tárhoz

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

Az első parancsmag lekéri a helyreállítási tárat. A második és a harmadik parancsmag lekéri a felhasználó által létrehozott MSI-ket. A negyedik parancsmag hozzáadja a felhasználói MSI-ket a tárolóhoz. Az ötödik parancsmag a tárolóhoz hozzáadott identitásokat jeleníti meg.

3. példa: SystemAssigned és UserAssigned identitások eltávolítása a tárolóból

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

Az első parancsmag lekéri a helyreállítási tárat. A második parancsmag eltávolítja a SystemAssigned identitást a tárolóból. A harmadik parancsmag lekéri az összes felhasználói MSI-t listaként a tárolóból. A negyedik parancsmag eltávolítja az összes felhasználói MSI-t a tárolóból. Ha szeretné, megadhatja, hogy a kijelölt felhasználói identitások vesszővel elválasztva legyenek, például az előző példában. Az ötödik parancsmag a tárolóban lévő identitásokat jeleníti meg, mivel eltávolítottuk az összes identitot, a Type a None (Nincs) állapotban jelenik meg.

4. példa: Update PublicNetworkAccess, ImmutabilityState of Recovery Services Vault

$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

Az első parancsmag lekéri a helyreállítási tárat. A második parancsmag frissíti a Recovery Services-tároló PublicNetworkAccess, ImmutabilityState tulajdonságait. A harmadik és negyedik parancs a tároló nyilvános hálózati hozzáférésének és nem módosítható állapotának lekérésére szolgál.

5. példa: CrossSubscriptionRestore engedélyezése/letiltása helyreállítási tárhoz

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

Disabled

Az első parancsmag lekéri a helyreállítási tárat. A második parancsmag frissíti a helyreállítási tár CrossSubscriptionRestoreState elemét. A harmadik parancs lekéri a tároló előfizetések közötti visszaállítási állapotát.

Paraméterek

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CrossSubscriptionRestoreState

A tároló előfizetések közötti visszaállítási állapota. Az engedélyezett értékek a következők: "Enabled", "Disabled", "PermanentlyDisabled".

Type:	Nullable<T>[CrossSubscriptionRestoreState]
Accepted values:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableAzureMonitorAlertsForJobFailure

Logikai paraméter, amely meghatározza, hogy minden feladathiba esetén meg kell-e kapni a beépített Azure Monitor-riasztásokat.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableClassicAlerts

Logikai paraméter annak megadásához, hogy a klasszikus megoldás biztonsági mentési riasztásai le legyenek tiltva vagy engedélyezve legyenek.

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityId

A hozzáadandó/eltávolítandó UserAssigned Identitás ARM-azonosítói. Ez az identitásazonosítók vesszővel tagolt listája.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IdentityType

A Recovery Services-tárolóhoz rendelt MSI-típus.

Type:	MSIdentity
Accepted values:	SystemAssigned, None, UserAssigned
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmutabilityState

A tároló nem módosítható állapota. Az engedélyezett értékek a következők: "Letiltva", "Feloldva", "Zárolva". A zárolás feloldása azt jelenti, hogy engedélyezve van, és módosítható, a zárolt érték azt jelenti, hogy engedélyezve van, és nem módosítható.

Type:	Nullable<T>[ImmutabilityState]
Accepted values:	Disabled, Unlocked, Locked
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Megadja a frissíteni kívánt helyreállítási tár nevét.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicNetworkAccess

Paraméter a tároló nyilvános hálózati hozzáférésének engedélyezéséhez/letiltásához. Ez a beállítás a privát végpontok esetén hasznos.

Type:	Nullable<T>[PublicNetworkAccess]
Accepted values:	Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSystemAssigned

Adja meg ezt a kapcsolót a SystemAssigned Identity tárolóból való eltávolításához.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUserAssigned

Adja meg ezt a kapcsolót a UserAssigned Identity tárolóból való eltávolításához. Adja meg az IdenityId paramétert is ezzel a kapcsolóval együtt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Annak az Azure-erőforráscsoportnak a nevét adja meg, amelyben a Recovery Services-tároló található.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Bevitelek

String

Kimenetek

Vault