Set-SCVirtualDiskDrive

Modifie les paramètres d’un lecteur de disque virtuel.

Syntax

Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -StorageQoSPolicy <StorageQoSPolicy>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   -IOPSMaximum <UInt64>
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDiskDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-SCSI]
   [-IDE]
   [-VolumeType <VolumeType>]
   [-StorageClassification <StorageClassification>]
   [-SharedStorage <Boolean>]
   [-CreateDiffDisk <Boolean>]
   -VirtualDiskDrive <VirtualDiskDrive>
   [-JobGroup <Guid>]
   [-DisableStorageQoS]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Set-SCVirtualDiskDrive modifie les paramètres d’un objet de lecteur de disque virtuel sur une machine virtuelle ou sur un modèle de machine virtuelle dans un environnement VMM (Virtual Machine Manager). Vous pouvez utiliser cette applet de commande pour modifier le type de bus (IDE ou SCSI) ou pour modifier les paramètres Bus et LUN pour connecter un lecteur de disque virtuel à un autre emplacement sur le bus.

Exemples

Exemple 1 : Modifier les paramètres du bus IDE et de l’unité logique pour un lecteur de disque virtuel

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -VM $VM)
PS C:\> If($VirtDiskDrive.Count -Eq 1 -And $VirtDiskDrive[0].Bus -Eq 0 -And $VirtDiskDrive[0].Lun -Eq 1){Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[0] -Bus 0 -LUN 0}

La première commande obtient la machine virtuelle VM01 à l’aide de l’applet de commande Get-SCVirtualMachine . La commande stocke cet objet dans la variable $VM.

La deuxième commande obtient l’objet de lecteur de disque virtuel sur VM01, puis stocke l’objet dans $VirtDiskDrive. En utilisant le symbole @ et les parenthèses, assurez-vous que la commande stocke les résultats dans un tableau même si la commande retourne un objet unique ou une valeur de $Null.

La dernière commande définit la valeur Bus sur 0 et définit la valeur lun sur 0 pour le lecteur de disque virtuel sur VM01, si la machine virtuelle n’a qu’un seul lecteur de disque virtuel et se trouve sur le deuxième emplacement du premier canal IDE.

Exemple 2 : Modifier le type de bus d’un lecteur de disque virtuel de SCSI vers IDE

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> Set-SCVirtualDiskDrive -VirtualDiskDrive $VirtDiskDrive[1] -IDE -Bus 0 -LUN 1

La première commande obtient l’objet de machine virtuelle nommé VM02, puis stocke cet objet dans la variable $VM.

La deuxième commande obtient tous les objets de lecteur de disque virtuel configurés pour la machine virtuelle stockée dans $VM et stocke ces objets de lecteur de disque virtuel dans le tableau d’objets $VirtDiskDrive. Cet exemple suppose que le lecteur de disque virtuel se trouve sur un bus SCSI.

La dernière commande définit le type bus sur IDE. La commande connecte le deuxième lecteur de disque virtuel, spécifié par $VirtDiskDrive[1], au canal principal (1) et à l’emplacement 2, spécifié par -Bus 0 et LUN 1.

Paramètres

-Bus

Spécifie le bus IDE auquel attacher un lecteur de disque virtuel ou le bus SCSI auquel attacher un lecteur de disque virtuel.

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

-CreateDiffDisk

Indique si l’applet de commande crée un disque de différenciation.

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

-DisableStorageQoS

Indique que cette applet de commande désactive les normes de qualité de service (QoS) de stockage.

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

-IDE

Indique que l’IDE est le type de bus auquel attacher un objet de lecteur de disque virtuel configuré sur une machine virtuelle ou sur un modèle.

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

-IOPSMaximum

Spécifie l’IOPS maximal.

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

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécutent en tant que jeu juste avant la commande finale qui inclut le même identificateur de groupe de travaux.

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

-JobVariable

Spécifie une variable dans laquelle la progression du travail est suivie et stockée.

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

-LUN

Spécifie le numéro d’unité logique (LUN) d’un objet de lecteur de disque virtuel ou d’un objet de lecteur de disque virtuel sur un bus SCSI.

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

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. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-SCSI

Spécifie SCSI comme type de bus auquel attacher un objet de lecteur de disque virtuel configuré sur une machine virtuelle ou sur un modèle.

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

-SharedStorage

Indique si le lecteur de disque virtuel utilise le stockage partagé.

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

-StorageClassification

Spécifie un objet de classification de stockage.

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

-StorageQoSPolicy

Spécifie une stratégie qoS de stockage.

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

-VirtualDiskDrive

Spécifie un objet lecteur de disque virtuel. Vous pouvez attacher un disque dur virtuel ou un disque pass-through à un objet de lecteur de disque virtuel.

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

-VolumeType

Spécifie le type de volume pour un disque dur virtuel. Les valeurs valides pour ce paramètre sont :

  • Démarrage
  • Système
  • BootAndSystem
  • Aucun
Type:VolumeType
Accepted values:None, Boot, System, BootAndSystem
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Sorties

VirtualDiskDrive

Cette applet de commande retourne un objet VirtualDiskDrive .

Notes

  • Cette applet de commande nécessite un objet de lecteur de disque virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualDiskDrive .