Partager via

New-SCVirtualScsiAdapter

  • Référence
Module:
VirtualMachineManager

Crée une carte SCSI virtuelle sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans VMM.

Syntaxe

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -JobGroup <Guid>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

La cmdlet New-SCVirtualScsiAdapter crée une carte SCSI virtuelle sur une machine virtuelle, un modèle de machine virtuelle ou un profil matériel utilisé dans un environnement Virtual Machine Manager (VMM). Après avoir créé l’adaptateur SCSI virtuel, vous pouvez utiliser la cmdlet Set-SCVirtualScsiAdapter pour modifier ses paramètres.

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 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é.

Une machine virtuelle sur un hôte Citrix XenServer a toujours un adaptateur SCSI virtuel. Vous ne pouvez pas supprimer cet adaptateur ou ajouter d’autres adaptateurs.

Exemples

Exemple 1 : Créer une carte SCSI virtuelle sur une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM

La première commande obtient l’objet de machine virtuelle nommé VM01 et stocke l’objet dans la variable $VM.

La deuxième commande crée une carte SCSI virtuelle sur VM01.

Exemple 2 : Créer une carte SCSI virtuelle sur un modèle de machine virtuelle

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualScsiAdapter -VMTemplate $VMTemplate

La première commande obtient l’objet de modèle de machine virtuelle nommé VMTemplate01 à partir de la bibliothèque VMM et stocke l’objet dans la variable $VMTemplate.

La deuxième commande crée une carte SCSI virtuelle sur VMTemplate01.

Exemple 3 : Créer une carte SCSI virtuelle sur un profil matériel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualScsiAdapter -HardwareProfile $HWProfile

La première commande obtient l’objet de profil matériel nommé NewHWProfile01 à partir de la bibliothèque VMM et stocke l’objet dans la variable $HWProfile.

La deuxième commande crée une carte SCSI virtuelle sur NewHWProfile01.

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:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-HardwareProfile

Spécifie un objet de profil matériel.

Type:HardwareProfile
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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:True
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é.

  • 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

-Synthetic

Indique qu’un appareil, tel qu’une carte réseau virtuelle, sur une machine virtuelle déployée sur un hôte Hyper-V est un appareil synthétique hautes performances. Nécessite un système d’exploitation invité prenant en compte la virtualisation sur la machine virtuelle.

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

-VM

Spécifie un objet de machine virtuelle.

Type:VM
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMTemplate

Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.

Type:Template
Alias:Template
Position:Named
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 de machine virtuelle VMM, un objet de modèle de machine virtuelle ou un objet de profil matériel, qui peut être récupéré à l’aide des Get-SCVirtualMachine, Get-SCVMTemplate, ou Get-SCHardwareProfile applets de commande, respectivement.