Set-SCVirtualHardDiskConfiguration

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

Syntax

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 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 du disque dur virtuel stocké dans $VHDConfig pour le disque dur virtuel source stocké dans $VHD pour épingler la valeur du disque dur virtuel source, ce qui empêche sa modification lors du placement.

Paramètres

-DeploymentOption

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

  • Aucun
  • UseFastest
  • UseTarget
  • UseNetwork
  • UseSAN
  • UseDifferencing
  • UseExistingVirtualDisk
Type:DeploymentOption
Accepted values:None, UseFastest, UseTarget, UseNetwork, UseSAN, UseDifferencing, UseExistingVirtualDisk
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationLocation

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

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

-FileInjectionDestinationLocation

Spécifie le chemin du dossier cible (chemin relatif à la racine de la partition) où 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileName

Spécifie le nom de fichier à utiliser pour renommer un fichier de disque dur virtuel lorsque vous l’ajoutez à un ordinateur virtuel.

Type:String
Position:Named
Default value:None
Required:False
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

-ParentVirtualHardDiskDestinationPath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PinDestinationLocation

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

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

-PinFileName

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

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

-PinSourceLocation

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

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

-PinStorageDisk

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

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

-SourceDisk

Spécifie le disque dur virtuel source.

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

-StorageDisk

Spécifie un disque d’un ordinateur hôte Hyper-V ou VMware ESX qu’un ordinateur virtuel de cet ordinateur hôte peut utiliser à la place d’un disque dur virtuel. Ce disque est appelé disque pass-through. Le terme VMware correspondant est le mappage d’appareils bruts (RDM). Le disque hôte est un disque dur local ou une unité logique d’un réseau SAN. VMM permet à l’ordinateur virtuel de passer outre le système de fichiers de l’ordinateur hôte et d’accéder directement au disque direct. Les hôtes Hyper-V 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StorageQoSPolicy

Spécifie un objet StorageQoSPolicy .

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

-VHDConfiguration

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

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

Sorties

VirtualHardDiskConfiguration

Cette applet de commande retourne un objet VirtualHardDiskConfiguration .