Delen via


Update-AzRecoveryServicesVault

Hiermee wordt MSIdentity bijgewerkt naar de Recovery Services-kluis.

Syntaxis

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

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
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CrossSubscriptionRestoreState

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

Type:Nullable<T>[CrossSubscriptionRestoreState]
Geaccepteerde waarden:Enabled, Disabled, PermanentlyDisabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-IdentityType

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

Type:MSIdentity
Geaccepteerde waarden:SystemAssigned, None, UserAssigned
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren: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]
Geaccepteerde waarden:Disabled, Unlocked, Locked
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

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

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicNetworkAccess

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

Type:Nullable<T>[PublicNetworkAccess]
Geaccepteerde waarden:Enabled, Disabled
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RemoveSystemAssigned

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Token

Parameter voor het autoriseren van bewerkingen die worden beveiligd door resourcebeveiliging voor meerdere tenants. Gebruik de opdracht (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token voor het ophalen van autorisatietoken voor verschillende tenants

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

Uitvoerwaarden

Vault