Remove-SCLibraryServer
Supprime un serveur de bibliothèque de VMM.
Syntaxe
Default (Par défaut)
Remove-SCLibraryServer
[-LibraryServer] <LibraryServer>
-Credential <VMMCredential>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Remove-SCLibraryServer supprime un objet de 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 des fichiers .vhd ou .vmdk) stocké 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, de sorte que l’opération de suppression du serveur de bibliothèque échouera.
Si cet ordinateur est à la fois un serveur de bibliothèque et un hôte, cette applet de commande supprime uniquement la fonctionnalité de 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 (et non pas un hôte ou un serveur VMM), le serveur de bibliothèque est supprimé de VMM.
Cette applet de commande renvoie l’objet en cas de réussite (avec la propriété MarkedForDeletion définie sur $True) ou renvoie un message d’erreur en cas d’échec.
Exemples
Exemple 1 : Suppression d’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 transmettre qu’un seul objet de serveur de bibliothèque à l’applet de commande.
Exemple 2 : Supprimer plusieurs objets de serveur de bibliothèque dont le nom contient une chaîne spécifique
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 récupère tous les objets du serveur de bibliothèque de VMMServer01 avec des noms qui incluent la chaîne « LibraryServer » et stocke les objets renvoyés dans la variable $LibServers (un tableau d’objets).
La troisième commande transmet chaque objet du serveur de bibliothèque en $LibServers à Remove-SCLibraryServer, qui supprime chaque objet de VMM.
Exemple 3 : Supprimer un serveur de bibliothèque à haute disponibilité 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 stocke 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 avec des 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 confirmer que HAFileServer01 est un serveur de fichiers hautement disponible et stocke l’objet cluster dans la variable $Cluster.
La troisième commande supprime le serveur de fichiers à haute disponibilité (en spécifiant son nom) en tant que serveur de bibliothèque de VMM. La commande utilise le paramètre RunAsynchronously pour rendre 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 la fin de cette commande.
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 rendre 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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, a 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.
Propriétés du paramètre
| Type: | VMMCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LibraryServer
Spécifie un objet serveur de bibliothèque VMM.
Propriétés du paramètre
| Type: | LibraryServer |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.