Partager via


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

Syntax

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

L’applet de commande 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 l’applet de commande 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 des adaptateurs supplémentaires.

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

Type:Byte
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HardwareProfile

Spécifie un objet profil matériel.

Type:HardwareProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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:True
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 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
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 un adaptateur SCSI virtuel est partagé afin qu’il puisse être utilisé dans le clustering invité.

  • 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

-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. L’ordinateur virtuel doit posséder un système d’exploitation invité prenant en charge la virtualisation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VM

Spécifie un objet ordinateur virtuel.

Type:VM
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.

Type:Template
Aliases:Template
Position:Named
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 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 applets de commande Get-SCVirtualMachine, Get-SCVMTemplate ou Get-SCHardwareProfile , respectivement.