Remove-SCVirtualScsiAdapter
Supprime un objet d’adaptateur SCSI virtuel de VMM.
Syntaxe
Remove-SCVirtualScsiAdapter
[-VirtualScsiAdapter] <VirtualSCSIAdapter>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
L 'applet de commande remove-SCVirtualScsiAdapter supprime un ou plusieurs objets d’adaptateur SCSI virtuels d’une machine virtuelle, d’un modèle de machine virtuelle ou d’un profil matériel utilisé dans un environnement VMM (Virtual Machine Manager).
L 'applet de commande remove-SCVirtualSCSIAdapter supprime correctement une carte SCSI virtuelle uniquement si l’adaptateur n’a pas d’appareils connectés à celui-ci.
Une machine virtuelle sur un hôte Citrix XenServer a toujours un adaptateur SCSI virtuel. Vous ne pouvez pas supprimer cet adaptateur.
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 la troisième carte SCSI virtuelle d’une machine virtuelle
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualSCSIAdapter -VM $VM
PS C:\> $Adapter[2] | Remove-SCVirtualScsiAdapterLa première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.
La deuxième commande obtient tous les objets d’adaptateur SCSI virtuels sur VM01 et stocke les objets dans le tableau d’objets $Adapter. Une machine virtuelle peut avoir jusqu’à quatre adaptateurs SCSI virtuels attachés. Cet exemple suppose que VM01 a au moins trois adaptateurs SCSI virtuels.
La dernière commande passe la troisième carte SCSI virtuelle ($Adapter[2]) à Remove-SCVirtualScsiAdapter, ce qui supprime cette carte SCSI virtuelle de VM01.
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 |
-JobGroup
Spécifie un identificateur pour une série de commandes qui s’exécute en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.
| 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 |
-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 |
-OnBehalfOfUser
Spécifie le nom d’un utilisateur. Cette applet de commande définit le compte de l’utilisateur en tant qu’utilisateur spécifié 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 |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Cette applet de commande définit le rôle d’utilisateur pour le compte de l’utilisateur comme rôle d’utilisateur spécifié par ce paramètre. Pour obtenir un objet de rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole.
| Type: | UserRole |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| 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 |
-VirtualScsiAdapter
Spécifie un objet d’adaptateur SCSI virtuel pour une machine virtuelle.
Type de numéro d’hôte des adaptateurs SCSI virtuels
Hyper-V : jusqu’à quatre adaptateurs SCSI virtuels synthétiques par machine virtuelle et jusqu’à 64 appareils par adaptateur. Prend en charge une taille de lecteur de disque virtuel pouvant atteindre 2040 Go. Ne prend pas en charge les adaptateurs SCSI virtuels émulés. VMware ESX : jusqu’à quatre adaptateurs SCSI virtuels par machine virtuelle et jusqu’à 15 appareils par adaptateur. Prend en charge une taille de lecteur de disque virtuel pouvant atteindre 2048 Go. Citrix XenServer : Toujours un adaptateur SCSI virtuel par machine virtuelle et jusqu’à huit appareils par adaptateur. Prend en charge une taille de lecteur de disque virtuel pouvant atteindre 2048 Go.
| Type: | VirtualSCSIAdapter |
| Position: | 0 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| 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 |
Notes
- Nécessite un objet d’adaptateur SCSI virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande get-SCVirtualScsiAdapter
.