Partager via

Remove-SCLibraryServer

  • Référence
Module:
VirtualMachineManager

Supprime un serveur de bibliothèque de VMM.

Syntaxe

Remove-SCLibraryServer
      [-LibraryServer] <LibraryServer>
      -Credential <VMMCredential>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

L’applet de commande Remove-SCLibraryServer supprime un objet serveur de bibliothèque (et tous les objets de bibliothèque sur ce serveur de bibliothèque) de la base de données Virtual Machine Manager (VMM). Les objets de bibliothèque qui ont un fichier correspondant (tel que les fichiers .vhd ou .vmdk) stockés sur le système de fichiers du serveur ne sont pas supprimés du système de fichiers par cette applet de commande.

Cette applet de commande fonctionne comme suit :

  • Si ce serveur de bibliothèque est également le serveur VMM, vous ne pouvez pas supprimer le serveur de bibliothèque. Par conséquent, l’opération supprimer le serveur de bibliothèque échoue.

  • Si cet ordinateur est à la fois un serveur de bibliothèque et un hôte, cette applet de commande supprime uniquement la fonctionnalité serveur de bibliothèque de VMM, mais l’ordinateur continue de fonctionner en tant qu’hôte.

  • Si cet ordinateur n’est qu’un serveur de bibliothèque (pas non plus un hôte ou un serveur VMM), le serveur de bibliothèque est supprimé de VMM.

Cette applet de commande retourne l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou retourne un message d’erreur en cas d’échec.

Exemples

Exemple 1 : Supprimer un objet serveur de bibliothèque de VMM

PS C:\> $Creds = Get-Credential
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer1.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Remove-SCLibraryServer -LibraryServer $LibServ -Credential $Creds

La première commande vous invite à entrer des informations d’identification. Lorsque la boîte de dialogue s’affiche, tapez le nom d’utilisateur et le mot de passe d’un compte d’administrateur local ou d’un compte de domaine avec des droits d’administrateur sur le serveur de bibliothèque.

La deuxième commande récupère l’objet de serveur de bibliothèque nommé LibraryServer01 sur VMMServer01 et le stocke dans la variable $LibServ.

La troisième commande supprime l’objet serveur de bibliothèque et tous les partages de bibliothèque sur ce serveur, de la bibliothèque VMM. Lorsque l’applet de commande Remove-SCLibraryServer est utilisée avec le paramètre LibraryServer, comme illustré dans cet exemple, vous ne pouvez passer qu’un seul objet serveur de bibliothèque à l’applet de commande.

Exemple 2 : Supprimer plusieurs objets serveur de bibliothèque qui ont une chaîne spécifique dans leur nom

PS C:\> $Creds = Get-Credential
PS C:\> $LibServers = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "LibraryServer" }
PS C:\> $LibServers | Remove-SCLibraryServer -Credential $Creds

La première commande vous invite à entrer des informations d’identification. Lorsque la boîte de dialogue s’affiche, tapez le nom d’utilisateur et le mot de passe d’un compte d’administrateur local ou d’un compte de domaine avec des droits d’administrateur sur le serveur de bibliothèque.

La deuxième commande obtient tous les objets serveur de bibliothèque de VMMServer01 avec des noms qui incluent la chaîne « LibraryServer » et stocke les objets retournés dans la variable $LibServers (tableau d’objets).

La troisième commande transmet chaque objet serveur de bibliothèque dans $LibServers à Remove-SCLibraryServer, qui supprime chaque objet de VMM.

Exemple 3 : Supprimer un serveur de bibliothèque hautement disponible et tous ses nœuds

PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Remove-LibraryServer -LibraryServer "HAFileServer01.Contoso.com" -Credential $Credential -RunAsynchronously
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) {Remove-LibraryServer -LibraryServer $Node -Credential $Credential -RunAsynchronously}

La première commande utilise Obtenir les informations d’identification pour vous inviter à fournir un nom d’utilisateur et un mot de passe et à stocker vos informations d’identification dans $Credential. Les informations d’identification requises pour cette opération sont soit un compte d’administrateur local, soit un compte de domaine disposant de droits d’administrateur sur le serveur de bibliothèque. Les commandes suivantes utilisent $Credential pour transmettre vos informations d’identification à chaque applet de commande qui nécessite des informations d’identification.

La deuxième commande utilise l’applet de commande Find-SCCluster pour vérifier que HAFileServer01 est un serveur de fichiers hautement disponible et stocke l’objet de cluster dans la variable $Cluster.

La troisième commande supprime le serveur de fichiers hautement disponible (en spécifiant son nom) en tant que serveur de bibliothèque de VMM. La commande utilise le paramètre RunAsynchronously pour retourner le contrôle à l’interpréteur de commandes immédiatement (avant la fin de cette commande), car la dernière commande n’a pas besoin d’attendre une fois cette commande terminée.

La dernière commande utilise une boucle ForEach pour passer chaque objet stocké dans $Cluster.ClusterNodes à l’applet de commande Remove-SCLibraryServer, qui supprime chaque nœud de VMM. La commande utilise le paramètre RunAsynchronously pour retourner immédiatement le contrôle à l’interpréteur de commandes. Pour plus d’informations sur les serveurs de bibliothèque, tapez Get-Help Add-LibraryServer -Detailed. Pour plus d’informations sur l’instruction de boucle Windows PowerShell ForEach, tapez Get-Help about_ForEach.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet d’informations d’identification ou, pour certaines applets de commande, un objet de compte d’identification qui contient le nom d’utilisateur et le mot de passe d’un compte autorisé à effectuer cette action. Ou, dans le cas de restart-SCJob, dispose de l’autorisation d’effectuer une tâche redémarrée.

Pour plus d’informations sur l’objet PSCredential , tapez .

Pour plus d’informations sur les comptes d’identification, tapez Get-Help New-SCRunAsAccount.

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

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

-LibraryServer

Spécifie un objet serveur de bibliothèque VMM.

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

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils pro.

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

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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