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 $VMLa 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 $VMTemplateLa 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 $HWProfileLa 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.