Update-AzRecoveryServicesVault

Modul:
Az.RecoveryServices Module

Aktualisiert MSIdentity auf den Wiederherstellungsdiensttresor.

Syntax

AzureRSVaultRemoveMSIdentity (Standard) 

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

AzureRSVaultAddMSIdentity 

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

Beschreibung

Dieses Cmdlet wird verwendet, um die MSI-Datei aus dem Wiederherstellungsdiensttresor hinzuzufügen oder daraus zu entfernen. Verwenden Sie -IdentityType Param, um der RSVault eine SystemAssigned/UserAssigned-Identität hinzuzufügen. Verwenden Sie removeSystemAssigned/RemoveUserAssigned Switch, um die MSI aus dem Tresor zu entfernen. Darüber hinaus kann dieses Cmdlet verwendet werden, um Tresoreinstellungen zu konfigurieren, z. B. Kostenverwaltungs granularität, öffentlicher Netzwerkzugriff, Unveränderlichkeitsstatus und zustandsübergreifendes Wiederherstellen von Abonnements.

Beispiele

Beispiel 1: Hinzufügen der SystemAssigned-Identität zum Wiederherstellungsdiensttresor

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

Dieses Cmdlet wird verwendet, um einem Wiederherstellungsdiensttresor eine SystemAssigned-Identität hinzuzufügen.

Beispiel 2: Hinzufügen der UserAssigned-Identität zum Wiederherstellungsdiensttresor

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

Das erste Cmdlet ruft den Wiederherstellungsdiensttresor ab. Das zweite und dritte Cmdlet ruft die vom Benutzer erstellten MSIs ab. Das vierte Cmdlet fügt den Benutzer-MSIs zum Tresor hinzu. Das fünfte Cmdlet zeigt die Identitäten, die dem Tresor hinzugefügt wurden.

Beispiel 3: Entfernen von SystemAssigned- und UserAssigned-Identitäten aus dem Tresor

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

Das erste Cmdlet ruft den Wiederherstellungsdiensttresor ab. Das zweite Cmdlet entfernt die SystemAssigned-Identität aus dem Tresor. Das dritte Cmdlet ruft alle Benutzer-MSIs als Liste aus dem Tresor ab. Das vierte Cmdlet entfernt alle Benutzer-MSIs aus dem Tresor. Wenn Sie möchten, können Sie ausgewählte Benutzeridentitäten angeben, die wie im vorherigen Beispiel als Komma getrennt entfernt werden sollen. Das fünfte Cmdlet zeigt die Identitäten im Tresor an, während alle Identitäten entfernt wurden, wird "Typ" als "Keine" angezeigt.

Beispiel 4: Aktualisieren von PublicNetworkAccess, Unveränderbarkeitsstatus des Wiederherstellungsdiensttresors

$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

Das erste Cmdlet ruft den Wiederherstellungsdiensttresor ab. Das zweite Cmdlet aktualisiert PublicNetworkAccess, ImmutabilityState-Eigenschaften des Wiederherstellungsdienstetress. Der dritte und vierte Befehl werden verwendet, um den Zugriff auf das öffentliche Netzwerk und den Unveränderlichkeitszustand des Tresors abzurufen.

Beispiel 5: Aktivieren/Deaktivieren von CrossSubscriptionRestore für den Wiederherstellungsdiensttresor

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

Disabled

Das erste Cmdlet ruft den Wiederherstellungsdiensttresor ab. Das zweite Cmdlet aktualisiert CrossSubscriptionRestoreState des Wiederherstellungsdienste-Tresors. Der dritte Befehl ruft den Zustand der abonnementübergreifenden Wiederherstellung des Tresors ab.

Beispiel 6: Aktualisieren der CostManagementGranularity für den Wiederherstellungsdiensttresor

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -CostManagementGranularity "VaultLevel"
$updatedVault.Properties.CostManagementSettings.GranularityLevel

VaultLevel

Das erste Cmdlet ruft den Wiederherstellungsdiensttresor ab. Das zweite Cmdlet aktualisiert die CostManagementGranularity auf "VaultLevel". Zulässige Werte sind "VaultLevel", "ProtectedItemLevel" und "ProtectedItemWithParentTag". Der dritte Befehl erhält die Granularitätsebene des Kostenmanagements des Tresors.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CostManagementGranularity

Gibt die Granularitätsebene für Kostenverwaltungseinstellungen des Tresors an. Dieser Parameter steuert die Ebene, auf der Kostendaten nachverfolgt und gemeldet werden.

Parametereigenschaften

Typ:

Nullable<T>[CostManagementGranularity]

Standardwert:None
Zulässige Werte:VaultLevel, ProtectedItemLevel, ProtectedItemWithParentTag
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CrossSubscriptionRestoreState

Abonnementübergreifender Wiederherstellungsstatus des Tresors. Zulässige Werte sind "Enabled", "Disabled", "PermanentDisabled".

Parametereigenschaften

Typ:

Nullable<T>[CrossSubscriptionRestoreState]

Standardwert:None
Zulässige Werte:Enabled, Disabled, PermanentlyDisabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableAzureMonitorAlertsForAllFailoverIssue

Aktiviert oder deaktiviert Überwachungswarnungen für Failoverproblem im RS Vault.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableAzureMonitorAlertsForAllReplicationIssue

Aktiviert oder deaktiviert überwachungsbenachrichtigungen für Replikationsproblem im RS Vault.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableAzureMonitorAlertsForJobFailure

Boolescher Parameter, um anzugeben, ob integrierte Azure Monitor Warnungen für jeden Auftragsfehler empfangen werden sollen.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableClassicAlerts

Boolescher Parameter, um anzugeben, ob Sicherungswarnungen aus der klassischen Lösung deaktiviert oder aktiviert werden sollen.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableEmailNotificationsForSiteRecovery

Aktiviert oder deaktiviert klassische E-Mail-Benachrichtigungen für Site Recovery im RS Vault.

Parametereigenschaften

Typ:

Nullable<T>[Boolean]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IdentityId

ARM-IDs der userAssigned Identity, die hinzugefügt/entfernt werden sollen. Dies ist eine durch Trennzeichen getrennte Liste von Identitäts-IDs.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IdentityType

Der MSI-Typ, der recovery Services Vault zugewiesen ist.

Parametereigenschaften

Typ:MSIdentity
Standardwert:None
Zulässige Werte:SystemAssigned, None, UserAssigned
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AzureRSVaultAddMSIdentity
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ImmutabilityState

Unveränderlichkeitszustand des Tresors. Zulässige Werte sind "Disabled", "Unlocked", "Locked". Entsperrt bedeutet "Aktiviert" und kann geändert werden, "Gesperrt" bedeutet "Aktiviert" und kann nicht geändert werden.

Parametereigenschaften

Typ:

Nullable<T>[ImmutabilityState]

Standardwert:None
Zulässige Werte:Disabled, Unlocked, Locked
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen des zu aktualisierenden Wiederherstellungsdienste-Tresors an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublicNetworkAccess

Parameter zum Aktivieren/Deaktivieren des öffentlichen Netzwerkzugriffs des Tresors. Diese Einstellung ist bei privaten Endpunkten nützlich.

Parametereigenschaften

Typ:

Nullable<T>[PublicNetworkAccess]

Standardwert:None
Zulässige Werte:Enabled, Disabled
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemoveSystemAssigned

Stellen Sie diesen Switch bereit, um SystemAssigned Identity aus dem Tresor zu entfernen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AzureRSVaultRemoveMSIdentity
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RemoveUserAssigned

Stellen Sie diesen Switch bereit, um UserAssigned Identity aus dem Tresor zu entfernen. Stellen Sie außerdem den Parameter "IdentityId" zusammen mit diesem Switch bereit.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AzureRSVaultRemoveMSIdentity
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Azure Ressourcengruppe an, in der der Wiederherstellungsdiensttresor vorhanden ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SecureToken

Parameter zum Autorisieren von Vorgängen, die durch mandantenübergreifenden Ressourcenschutz geschützt sind. Befehl verwenden (Get-AzAccessToken -TenantId "xx-xxxx-xxxx-xxxx-xxxx-xxxxxx"). Token zum Abrufen des Autorisierungstokens für unterschiedliche Mandanten

Parametereigenschaften

Typ:SecureString
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Token

Parameter zum Autorisieren von Vorgängen, die durch mandantenübergreifenden Ressourcenschutz geschützt sind. Befehl verwenden (Get-AzAccessToken -TenantId "xx-xxxx-xxxx-xxxx-xxxx-xxxxxx"). Token zum Abrufen des Autorisierungstokens für unterschiedliche Mandanten

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

Ausgaben

Vault