Partager via

Set-SCVirtualScsiAdapter

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’une carte SCSI virtuelle utilisée dans VMM.

Syntax

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

Description

L’applet de commande Set-SCVirtualScsiAdapter 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’une carte SCSI virtuelle ou non partagée 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é est prise en charge uniquement 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 d’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 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 également utilisé pour une machine virtuelle sur un hôte XenServer, car les machines virtuelles XenServer ont toujours un adaptateur SCSI exactement.

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és. Pour un hôte VMware ESX, la valeur par défaut est 7 et ne peut pas être modifiée.

Type:Byte
Position:Named
Default value:None
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

-ScsiControllerType

Spécifie un type de contrôleur SCSI. Les valeurs autorisées sont :

  • DefaultType
  • NoType
  • LsiLogic
  • Buslogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Accepted values:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareVirtualScsiAdapter

Indique si une carte SCSI virtuelle est partagée afin qu’elle puisse être utilisée dans le clustering invité.

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

  • Hôte Hyper-V : 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
Aliases:Shared
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

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 .