Share via

Remove-SCLibraryServer

  • Référence
Module:
VirtualMachineManager

Supprime un serveur de bibliothèque de VMM.

Syntax

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 bibliothèque dont un fichier correspondant (tel que les fichiers .vhd ou .vmdk) est stocké sur le système de fichiers du serveur ne sont pas supprimés du système de fichiers par cette cmdlet.

Cette cmdlet fonctionne de la façon suivante :

  • Si ce serveur de bibliothèque est également le serveur VMM, vous ne pouvez pas supprimer le serveur de bibliothèque, de sorte que l’opération de suppression du 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 pour un compte d’administrateur local ou un compte de domaine disposant de droits d’administrateur sur le serveur de bibliothèque.

La deuxième commande récupère l’objet 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 indiqué 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 pour un compte d’administrateur local ou un compte de domaine disposant de 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 de serveur de bibliothèque dans $LibServers à Remove-SCLibraryServer, ce 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 Get-Credential 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 un compte d’administrateur local ou un compte de domaine disposant des droits d’administrateur sur le serveur de bibliothèque. Les commandes suivantes utilisent $Credential pour transmettre vos informations d’identification à chaque cmdlet qui les nécessite.

La deuxième commande utilise l’applet de commande Find-SCCluster pour confirmer 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 que cette commande soit terminée.

La dernière commande utilise une boucle ForEach pour transmettre 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 ForEach Windows PowerShell, tapez Get-Help about_ForEach.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Get-Help Get-Credential.

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

Type:VMMCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryServer

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

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False