Unregister-AzRecoveryServicesBackupContainer

  • Referenz
Modul:
Az.RecoveryServices

Hebt die Registrierung eines Windows Server- oder eines anderen Containers aus dem Tresor auf.

Syntax

Unregister-AzRecoveryServicesBackupContainer
          [-Container] <ContainerBase>
          [-PassThru]
          [-Force]
          [-VaultId <String>]
          [-DefaultProfile <IAzureContextContainer>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Unregister-AzRecoveryServicesBackupContainer " wird die Registrierung eines Windows Server- oder eines anderen Sicherungscontainers aus dem Tresor aufgehoben. Mit diesem Cmdlet werden Verweise auf einen Container aus dem Tresor entfernt. Bevor Sie die Registrierung eines Containers aufheben können, müssen Sie alle geschützten Daten löschen, die diesem Container zugeordnet sind. Legen Sie den Tresorkontext mithilfe des Cmdlets Set-AzRecoveryServicesVaultContext fest, bevor Sie das aktuelle Cmdlet verwenden.

Beispiele

Beispiel 1: Aufheben der Registrierung eines Windows Server aus dem Tresor

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Cont = Get-AzRecoveryServicesBackupContainer -ContainerType "Windows" -BackupManagementType MAB -VaultId $vault.ID
Unregister-AzRecoveryServicesBackupContainer -Container $Cont

Der erste Befehl ruft den Windows-Container mit dem Namen server01.contoso.com ab, der im Tresor registriert ist, und speichert ihn dann in der variablen $Cont. Der zweite Befehl hebt die Registrierung des angegebenen Windows Server aus dem Azure Backup Vault auf.

Beispiel 2

Hebt die Registrierung eines Windows Server- oder eines anderen Containers aus dem Tresor auf. (automatisch generiert)

Unregister-AzRecoveryServicesBackupContainer -Container $Cont -VaultId $vault.ID

Beispiel 3: Aufheben der Registrierung eines MSSQL-Containers aus dem Tresor

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "resourceGroup" -Name "vaultName"
$Cont = Get-AzRecoveryServicesBackupContainer -ContainerType AzureVMAppContainer -BackupManagementType AzureWorkload -VaultId $vault.ID | Where-Object { $_.Name -match "pstest-vm" }
Unregister-AzRecoveryServicesBackupContainer -Container $Cont

WorkloadName     Operation            Status               StartTime                 EndTime                   JobID
------------     ---------            ------               ---------                 -------                   -----
sql-pstest-vm2   UnRegister           Completed            1/3/2024 6:26:54 AM       1/3/2024 6:29:18 AM       f8626j98-8027-7h89-aa77-1a7ed83f5645

Der erste Befehl ruft den Container mit dem Namen "pstest-vm" ab, der im Tresor registriert ist, und speichert ihn dann in der variablen $Cont. Der zweite Befehl hebt die Registrierung des angegebenen Sicherungscontainers aus dem Tresor der Wiederherstellungsdienste auf und gibt den Sicherungsauftrag aus, um den Abschluss zu überwachen und nachzuverfolgen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Container

Gibt ein Sicherungscontainerobjekt an, das die Registrierung aufheben soll. Verwenden Sie das Cmdlet Get-AzRecoveryServicesBackupContainer, um ein BackupContainer-Objekt abzurufen.

Typ:ContainerBase
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Aufheben der Registrierung des Containers erzwingen (Bestätigungsdialogfeld verhindert). Dieser Parameter ist optional.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt den container zurück, der gelöscht werden soll.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VaultId

ARM-ID des Recovery Services Vault.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

Ausgaben

ContainerBase