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 .