Remove-SCVirtualScsiAdapter
Supprime un objet d’adaptateur SCSI virtuel de VMM.
Syntax
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 Virtual Machine Manager (VMM).
L’applet de commande Remove-SCVirtualSCSIAdapter supprime correctement une carte SCSI virtuelle uniquement si l’adaptateur n’a aucun appareil associé.
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-SCVirtualScsiAdapter
La 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. Vous pouvez connecter un maximum de quatre cartes SCSI virtuelles à un ordinateur virtuel. Cet exemple suppose que VM01 possède au moins trois adaptateurs SCSI virtuels.
La dernière commande transmet la troisième carte SCSI virtuelle ($Adapter[2]) à Remove-SCVirtualScsiAdapter, qui supprime cette carte SCSI virtuelle de VM01.
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 |
-JobGroup
Spécifie un identificateur pour une série de commandes qui seront exécutées ensemble juste avant que la commande finale qui comprend le même identificateur de groupe de travaux soit exécutée.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-OnBehalfOfUser
Spécifie le nom d'un utilisateur. Cette applet de commande définit le nom de l’utilisateur comme utilisateur spécifié par ce paramètre.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Cette applet de commande définit le rôle d’utilisateur au nom 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Spécifie l’ID du conseil d’optimisation des performances et des ressources 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 |
-VirtualScsiAdapter
Spécifie un objet carte SCSI virtuelle pour un ordinateur virtuel.
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 un lecteur de disque virtuel jusqu’à 2 040 Go. Neprend pas en charge les cartes SCSI virtuelles émulées. VMware ESX : Jusqu’à quatre cartes SCSI virtuelles par machine virtuelle et jusqu’à 15 appareils par adaptateur. Prend en charge un lecteur de disque virtuel jusqu’à 2 048 Go. Citrix XenServer : Toujours un adaptateur SCSI virtuel par machine virtuelle et jusqu’à huit appareils par adaptateur. Prend en charge un lecteur de disque virtuel jusqu’à 2 048 Go.
Type: | VirtualSCSIAdapter |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
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 .