Partager via

Unregister-AzRecoveryServicesBackupContainer

  • Référence
Module:
Az.RecoveryServices

Annule l’inscription d’un serveur Windows ou d’un autre conteneur à partir du coffre.

Syntaxe

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

Description

L’applet de commande Unregister-AzRecoveryServicesBackupContainer annule l’inscription d’un serveur Windows ou d’un autre conteneur de sauvegarde à partir du coffre. Cette applet de commande supprime les références à un conteneur du coffre. Avant de pouvoir annuler l’inscription d’un conteneur, vous devez supprimer toutes les données protégées associées à ce conteneur. Définissez le contexte du coffre à l’aide de l’applet de commande Set-AzRecoveryServicesVaultContext avant d’utiliser l’applet de commande actuelle.

Exemples

Exemple 1 : désinscrire un serveur Windows à partir du coffre

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

La première commande obtient le conteneur Windows nommé server01.contoso.com inscrit dans le coffre, puis le stocke dans la variable $Cont. La deuxième commande annule l’inscription de Windows Server spécifié à partir du coffre Sauvegarde Azure.

Exemple 2

Annule l’inscription d’un serveur Windows ou d’un autre conteneur à partir du coffre. (généré automatiquement)

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

Exemple 3 : Désinscrire un conteneur MSSQL à partir du coffre

$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

La première commande obtient le conteneur portant le nom « pstest-vm » inscrit dans le coffre, puis le stocke dans la variable $Cont. La deuxième commande annule l’inscription du conteneur de sauvegarde spécifié à partir du coffre Recovery Services et génère le travail de sauvegarde pour surveiller et suivre l’achèvement.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter la commande cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Container

Spécifie un objet conteneur de sauvegarde à annuler l’inscription. Pour obtenir un objet BackupContainer , utilisez l’applet de commande Get-AzRecoveryServicesBackupContainer.

Type:ContainerBase
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Forcer l’annulation de l’inscription du conteneur (empêche la boîte de dialogue de confirmation). Ce paramètre est facultatif.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Retournez le conteneur à supprimer.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VaultId

ID ARM du coffre Recovery Services.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de la commande cmdlet.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Sorties

ContainerBase