Update-AzRecoveryServicesVault

Referentie

Module:: Az.RecoveryServices

Hiermee wordt MSIdentity bijgewerkt naar de Recovery Services-kluis.

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

Deze cmdlet wordt gebruikt om de MSI toe te voegen aan of te verwijderen uit de Recovery Services-kluis. Gebruik de parameter -IdentityType om een SystemAssigned/UserAssigned-identiteit toe te voegen aan de RSVault. Gebruik de switch RemoveSystemAssigned/RemoveUserAssigned om de MSI uit de kluis te verwijderen.

Voorbeelden

Voorbeeld 1: SystemAssigned-identiteit toevoegen aan de Recovery Services-kluis

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

Deze cmdlet wordt gebruikt om een SystemAssigned-identiteit toe te voegen aan een Recovery Services-kluis.

Voorbeeld 2: UserAssigned identity toevoegen aan de Recovery Services-kluis

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

Met de eerste cmdlet wordt de Recovery Services-kluis opgehaald. De tweede en derde cmdlet haalt de door de gebruiker gemaakte MSIS's op. Met de vierde cmdlet worden de msis van de gebruiker toegevoegd aan de kluis. De vijfde cmdlet toont de identiteiten die zijn toegevoegd aan de kluis.

Voorbeeld 3: SystemAssigned- en UserAssigned-identiteiten uit de kluis verwijderen

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

Met de eerste cmdlet wordt de Recovery Services-kluis opgehaald. Met de tweede cmdlet wordt de SystemAssigned-identiteit uit de kluis verwijderd. Met de derde cmdlet worden alle gebruikers-URI's opgehaald als een lijst uit de kluis. Met de vierde cmdlet worden alle gebruikers-MSIS's uit de kluis verwijderd. Als u wilt, kunt u geselecteerde gebruikersidentiteiten opgeven die moeten worden verwijderd als door komma's gescheiden, zoals in het vorige voorbeeld. De vijfde cmdlet toont de identiteiten in de kluis, omdat we alle id's hebben verwijderd, wordt Type weergegeven als Geen.

Voorbeeld 4: PublicNetworkAccess, ImmutabilityState van recovery services-kluis bijwerken

$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

Met de eerste cmdlet wordt de Recovery Services-kluis opgehaald. Met de tweede cmdlet worden de eigenschappen PublicNetworkAccess, ImmutabilityState van de Recovery Services-kluis bijgewerkt. De derde en vierde opdracht worden gebruikt om de openbare netwerktoegang en onveranderbaarheidsstatus van de kluis op te halen.

Voorbeeld 5: CrossSubscriptionRestore in- of uitschakelen voor Recovery Services-kluis

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

Disabled

Met de eerste cmdlet wordt de Recovery Services-kluis opgehaald. Met de tweede cmdlet wordt CrossSubscriptionRestoreState van de Recovery Services-kluis bijgewerkt. Met de derde opdracht wordt de herstelstatus van de kluis voor alle abonnementen opgehaald.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-CrossSubscriptionRestoreState

Herstelstatus van de kluis tussen abonnementen. Toegestane waarden zijn Ingeschakeld, Uitgeschakeld, PermanentDisabled.

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

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

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

-DisableAzureMonitorAlertsForJobFailure

Booleaanse paramter om op te geven of ingebouwde Azure Monitor-waarschuwingen moeten worden ontvangen voor elke taakfout.

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

-DisableClassicAlerts

Booleaanse paramter om op te geven of back-upwaarschuwingen van de klassieke oplossing moeten worden uitgeschakeld of ingeschakeld.

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

-IdentityId

ARM-id's van de UserAssigned Identity die moet worden toegevoegd/verwijderd. Dit is een door komma's gescheiden lijst met id's.

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

-IdentityType

Het MSI-type dat is toegewezen aan Recovery Services Vault.

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

-ImmutabilityState

Onveranderbaarheidsstatus van de kluis. Toegestane waarden zijn 'Uitgeschakeld', 'Ontgrendeld', 'Vergrendeld'. Ontgrendeld betekent ingeschakeld en kan worden gewijzigd, vergrendeld betekent ingeschakeld en kan niet worden gewijzigd.

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

Hiermee geeft u de naam van de Recovery Services-kluis die moet worden bijgewerkt.

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

-PublicNetworkAccess

Parameter voor het in-/uitschakelen van openbare netwerktoegang van de kluis. Deze instelling is handig voor privé-eindpunten.

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

-RemoveSystemAssigned

Geef deze schakeloptie op om SystemAssigned Identity uit de kluis te verwijderen.

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

-RemoveUserAssigned

Geef deze schakeloptie op om UserAssigned Identity uit de kluis te verwijderen. Geef ook de parameter IdenityId op samen met deze switch.

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

-ResourceGroupName

Hiermee geeft u de naam op van de Azure-resourcegroep waarin de Recovery Services-kluis aanwezig is.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

String

Uitvoerwaarden

Vault