Partager via

Set-SCVirtualHardDiskConfiguration

  • Référence
Module:
VirtualMachineManager

Modifie les informations de configuration de disque dur virtuel contenues dans une configuration de machine virtuelle.

Syntaxe

Set-SCVirtualHardDiskConfiguration
   [-SourceDisk <StandaloneVirtualHardDisk>]
   [-PinSourceLocation <Boolean>]
   [-DestinationLocation <String>]
   [-PinDestinationLocation <Boolean>]
   [-FileName <String>]
   [-PinFileName <Boolean>]
   [-DeploymentOption <DeploymentOption>]
   [-StorageDisk <StorageDisk>]
   [-StorageClassification <StorageClassification>]
   [-StorageQoSPolicy <StorageQoSPolicy>]
   [-PinStorageDisk <Boolean>]
   [-ParentVirtualHardDiskPath <String>]
   [-ParentVirtualHardDiskDestinationPath <String>]
   [-FileInjectionSourceLocation <String>]
   [-FileInjectionDestinationLocation <String>]
   [-FileInjectionDestinationPartition <Int16>]
   -VHDConfiguration <VirtualHardDiskConfiguration>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

L’applet de commande set-SCVirtualHardDiskConfiguration modifie les informations de configuration de disque dur virtuel contenues dans une configuration de machine virtuelle.

Exemples

Exemple 1 : Définir les propriétés d’une configuration de disque dur virtuel

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $VHDConfig = Get-SCVirtualHardDiskConfiguration -VMConfiguration $VMConfig[0]
PS C:\> $VHD = Get-SCVirtualHardDisk -Name "Win2k8R2BaseDisk.vhd"
PS C:\> Set-SCVirtualHardDiskConfiguration -VHDConfiguration $VHDConfig -SourceDisk $VHD -PinSourceLocation $True

La première commande obtient l’objet de configuration de service nommé Service01 et stocke l’objet dans la variable $ServiceConfig.

La deuxième commande obtient la configuration de niveau ordinateur de l’objet de configuration de service stocké dans $ServiceConfig et stocke l’objet dans la variable $TierConfig.

La troisième commande obtient la configuration de la machine virtuelle pour la configuration de la couche ordinateur stockée dans $TierConfig et stocke l’objet dans la variable $VMConfig.

La quatrième commande obtient la configuration du disque dur virtuel pour la première configuration de machine virtuelle stockée dans $VMConfig et stocke l’objet dans la variable $VHDConfig.

La cinquième commande obtient l’objet de disque dur virtuel nommé Win2k8R2BaseDisk.vhd à partir de la bibliothèque et stocke l’objet dans la variable $VHD.

La dernière commande met à jour la propriété PinSourceLocation dans la configuration de disque dur virtuel stockée dans $VHDConfig pour le disque dur virtuel source stocké dans $VHD pour épingler la valeur du disque dur virtuel source, ce qui l’empêche de changer pendant le placement.

Paramètres

-DeploymentOption

Spécifie l’option de déploiement d’un disque dur virtuel. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Aucun
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk
Type:DeploymentOption
Valeurs acceptées:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DestinationLocation

Spécifie le chemin d’accès de destination pour ou sur un disque dur virtuel.

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

-FileInjectionDestinationLocation

Spécifie le chemin du dossier cible (chemin relatif à la racine de la partition) où le ou les fichiers sources sont injectés dans le disque dur virtuel sélectionné avant d’activer la machine virtuelle pour la première fois.

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

-FileInjectionDestinationPartition

Spécifie la partition cible du disque dur virtuel sélectionné où les fichiers sources sont injectés avant d’activer la machine virtuelle pour la première fois.

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

-FileInjectionSourceLocation

Spécifie l’emplacement (URL) du ou des fichiers à injecter dans la machine virtuelle avant d’activer la machine virtuelle pour la première fois.

Lorsqu’un dossier est spécifié, tous les fichiers sous ce dossier sont injectés dans l’emplacement de destination spécifié.

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

-FileName

Spécifie le nom de fichier à utiliser lorsque vous renommez un fichier de disque dur virtuel lorsque vous l’ajoutez à une machine virtuelle.

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

-JobVariable

Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.

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

-ParentVirtualHardDiskDestinationPath

Spécifie le chemin de destination du disque dur virtuel parent.

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

-ParentVirtualHardDiskPath

Spécifie le chemin d’accès au disque dur virtuel parent à utiliser lors de la création d’un disque de différenciation.

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

-PinDestinationLocation

Indique si l’emplacement de destination choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-PinFileName

Indique si le nom de fichier choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-PinSourceLocation

Indique si l’emplacement source choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-PinStorageDisk

Indique si le disque de stockage choisi par l’utilisateur est conservé pendant la configuration du déploiement du service.

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

-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

-SourceDisk

Spécifie le disque dur virtuel source.

Type:StandaloneVirtualHardDisk
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

-StorageDisk

Spécifie un disque sur un hôte Hyper-V ou VMware ESX qu’une machine virtuelle sur cet hôte peut utiliser au lieu d’utiliser un disque dur virtuel. Ce disque est appelé disque pass-through. Le terme VMware correspondant est Raw Device Mapping (RDM). Le disque hôte est un disque dur local ou une unité logique sur un réseau san (Storage Area Network). VMM permet à la machine virtuelle de contourner le système de fichiers de l’hôte et d’accéder directement au disque direct. Hyper-V hôtes prennent en charge les disques pass-through et la conversion d’un disque pass-through vers un disque dur virtuel. Les hôtes VMware ESX prennent en charge les disques pass-through, mais pas la conversion de disque. Les hôtes Citrix XenServer ne prennent pas en charge les disques pass-through.

Type:StorageDisk
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 un objet StorageQoSPolicy.

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

-VHDConfiguration

Spécifie un objet de configuration de disque dur virtuel.

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

Sorties

VirtualHardDiskConfiguration

Cette applet de commande retourne un objet VirtualHardDiskConfiguration.