Partager via

Set-SCVirtualScsiAdapter

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’un adaptateur SCSI virtuel utilisé dans VMM.

Syntaxe

Set-SCVirtualScsiAdapter
   [-ScsiControllerType <VMSCSIControllerType>]
   [-VirtualScsiAdapter] <VirtualSCSIAdapter>
   [-AdapterID <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Le Set-SCVirtualScsiAdapter applet de commande modifie une ou plusieurs propriétés d’une carte SCSI virtuelle utilisée dans un environnement VMM (Virtual Machine Manager). Les paramètres que vous pouvez modifier incluent la spécification d’un adaptateur SCSI virtuel ou non partagé et la définition de l’ID de l’adaptateur.

Remarque : L’utilisation du paramètre ShareVirtualScsiAdapter pour partager une carte SCSI virtuelle sur une machine virtuelle afin d’activer le clustering invité n’est prise en charge que si la machine virtuelle est déployée sur un hôte VMware ESX. Le paramètre SharedVirtualScsiAdapter n’est pas utilisé pour une machine virtuelle sur un hôte Hyper-V, car une machine virtuelle sur un hôte Hyper-V utilise iSCSI pour le stockage partagé.

Remarque : Set-SCVirtualScsiAdapter n’est pas utilisé pour les hôtes Citrix XenServer, car l’adaptateur SCSI sur les machines virtuelles Citrix XenServer n’est pas configurable.

Exemples

Exemple 1 : Partager une carte SCSI virtuelle spécifique sur une machine virtuelle pour l’activer pour le clustering invité

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $Adapter = Get-SCVirtualScsiAdapter -VM $VM 
PS C:\> Set-SCVirtualSCSIAdapter -VirtualScsiAdapter $Adapter -ShareVirtualScsiAdapter $True

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 l’objet adaptateur SCSI sur VM01 et stocke l’objet dans la variable $Adapter. Cet exemple suppose que VM01 a un adaptateur SCSI virtuel. Toutefois, une machine virtuelle peut avoir jusqu’à quatre adaptateurs SCSI virtuels attachés.

La dernière commande active l’objet d’adaptateur SCSI virtuel stocké dans $Adapter et spécifie qu’il est partagé afin qu’il puisse être utilisé dans le clustering invité.

Remarque : L’utilisation du paramètre partagé pour partager une carte SCSI virtuelle sur une machine virtuelle est prise en charge uniquement si la machine virtuelle est déployée sur un hôte ESX. Le paramètre partagé n’est pas utilisé pour une machine virtuelle qu’un hôte Hyper-V, car une machine virtuelle sur un hôte Hyper-V utilise iSCSI pour le stockage partagé. Le paramètre partagé n’est pas utilisé pour une machine virtuelle sur un hôte XenServer, car les machines virtuelles basées sur XenServer ont toujours exactement un adaptateur SCSI.

Paramètres

-AdapterID

Spécifie le numéro d’unité logique ou l’ID d’unité logique. Hyper-V et XenServer n’exposent pas cette valeur et ne peuvent pas être modifiées. Pour un hôte VMware ESX, la valeur par défaut est 7 et ne peut pas être modifiée.

Type:Byte
Position:Named
Valeur par défaut:None
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

-ScsiControllerType

Spécifie un type de contrôleur SCSI. Les valeurs valides sont les suivantes :

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Valeurs acceptées:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ShareVirtualScsiAdapter

Indique si un adaptateur SCSI virtuel est partagé afin qu’il puisse être utilisé dans le clustering invité.

Type d’hôte : Hyper-V hôte utilise ce paramètre :

  • Hyper-V hôte : Non (pour le clustering invité, utilisez le stockage iSCSI)
  • Hôte XenServer : Non (les machines virtuelles Xen ont toujours exactement un adaptateur SCSI)

Remarque : lors du partage d’un contrôleur SCSI sur une machine virtuelle sur un hôte ESX, VMM définit par défaut la stratégie de partage SCSI sur VMware sur « physique ».

Type:Boolean
Alias:Shared
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

Sorties

VirtualSCSIAdapter

Cette applet de commande retourne un objet VirtualScsiAdapter.

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 .