Partager via

Set-SCVirtualDiskDrive

  • Référence
Module:
VirtualMachineManager

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

Syntaxe

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 Virtual Machine Manager (VMM). 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 d’ide bus et d’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 l’objet de 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. À l’aide du symbole @ et des 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 $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 en 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és 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CreateDiffDisk

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

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

-DisableStorageQoS

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

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

-IOPSMaximum

Spécifie le nombre maximal d’E/S par seconde.

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

-JobVariable

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

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

-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
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 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
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. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
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

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

-SharedStorage

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

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

-StorageClassification

Spécifie un objet de classification de stockage.

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

-StorageQoSPolicy

Spécifie une stratégie QoS de stockage.

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

-VirtualDiskDrive

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

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

-VolumeType

Spécifie le type de volume d’un disque dur virtuel. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Botte
  • Système
  • BootAndSystem
  • Aucun
Type:VolumeType
Valeurs acceptées:None, Boot, System, BootAndSystem
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 .