Partager via

Set-SCVirtualDiskDrive

Module:
VirtualMachineManager Module

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

Syntaxe

BusChanges (Par défaut) 

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

StorageQoSPolicy 

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

IOPSMaximum 

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

DisableStorageQoS 

Set-SCVirtualDiskDrive
    -VirtualDiskDrive <VirtualDiskDrive>
    [-Bus <Byte>]
    [-LUN <Byte>]
    [-SCSI]
    [-IDE]
    [-VolumeType <VolumeType>]
    [-StorageClassification <StorageClassification>]
    [-SharedStorage <Boolean>]
    [-CreateDiffDisk <Boolean>]
    [-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 d’unité 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 de bus et de LUN afin de connecter un lecteur de disque virtuel à un autre emplacement sur le bus.

Exemples

Exemple 1 : Modifier les paramètres du bus IDE et des LUN d’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 récupère l’objet 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 elle renvoie un seul objet ou une valeur $Null.

La dernière commande définit la valeur du bus sur 0 et la valeur du LUN sur 0 pour l’unité de disque virtuel sur VM01, si la machine virtuelle ne dispose que d’une seule unité de disque virtuel et se trouve sur le deuxième emplacement du premier canal IDE.

Exemple 2 : Changer le type de bus d’un lecteur de disque virtuel de SCSI à 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 récupère l’objet de machine virtuelle nommé VM02, puis stocke cet objet dans la variable $VM.

La deuxième commande récupère tous les objets d’unité de disque virtuel configurés pour la machine virtuelle stockée dans $VM et stocke ces objets d’unité 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 de 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 une unité de disque virtuel ou le bus SCSI auquel attacher une unité de disque virtuel.

Propriétés du paramètre

Type:Byte
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-CreateDiffDisk

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisableStorageQoS

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

DisableStorageQoS
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IDE

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IOPSMaximum

Spécifie le nombre maximal d’IOPS par seconde.

Propriétés du paramètre

Type:UInt64
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

IOPSMaximum
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobGroup

Spécifie un identificateur pour une série de commandes qui s’exécutent en tant qu’ensemble juste avant l’exécution de la commande finale qui inclut le même identificateur de groupe de tâches.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-JobVariable

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LUN

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

Propriétés du paramètre

Type:Byte
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OnBehalfOfUser

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:UserRole
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SCSI

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SharedStorage

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

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageClassification

Spécifie un objet de classification de stockage.

Propriétés du paramètre

Type:StorageClassification
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageQoSPolicy

Spécifie une stratégie QoS de stockage.

Propriétés du paramètre

Type:StorageQoSPolicy
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

StorageQoSPolicy
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VirtualDiskDrive

Spécifie un objet d’unité de disque virtuel. Vous pouvez attacher un disque dur virtuel ou un disque relais à un objet lecteur de disque virtuel.

Propriétés du paramètre

Type:VirtualDiskDrive
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VolumeType

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

  • Démarrage
  • Système
  • BootAndSystem (en anglais)
  • Aucun

Propriétés du paramètre

Type:VolumeType
Valeur par défaut:None
Valeurs acceptées:None, Boot, System, BootAndSystem
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Sorties

VirtualDiskDrive

Cette applet de commande retourne un objet VirtualDiskDrive .

Notes

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