Partager via

Set-SCVirtualHardDisk

  • Référence
Module:
VirtualMachineManager

Modifie les propriétés d’un objet de disque dur virtuel utilisé dans VMM.

Syntaxe

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

La Set-SCVirtualHardDisk applet de commande modifie une ou plusieurs propriétés d’un objet de disque dur virtuel utilisé dans un environnement Virtual Machine Manager (VMM). Un fichier de disque dur virtuel utilisé dans VMM est un fichier .vhd Windows, un fichier .vhd basé sur Citrix XenServer ou un fichier .vmdk basé sur VMware.

Les propriétés que vous pouvez modifier sont les suivantes :

  • Description
  • Activé
  • Nom
  • Système d’exploitation
  • Propriétaire
  • SharePath

Un fichier de disque dur virtuel peut être stocké dans la bibliothèque VMM, ou il peut être attaché à un lecteur de disque virtuel sur une machine virtuelle ou un modèle.

Pour modifier les paramètres Bus et LUN d’un lecteur de disque virtuel, utilisez l’applet de commande Set-SCVirtualDiskDrive .

Exemples

Exemple 1 : Modifier la description d’un disque dur virtuel

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

La première commande récupère l’objet de disque dur virtuel nommé « WindowsServer2003BootVHD.vhd » à partir de la bibliothèque sur VMMServer01, puis stocke l’objet dans la variable $VHD.

La deuxième commande modifie la description de l’objet de disque dur virtuel stocké dans $VHD en « Dernier disque dur virtuel de démarrage Windows Server 2008 R2 ».

Exemple 2 : Activer un disque dur virtuel VMware dans la bibliothèque

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

La première commande obtient l’objet de disque dur virtuel nommé WindowsServer2008.vmdk, puis stocke l’objet de disque dur virtuel dans la variable $VMDK.

La deuxième commande désactive l’objet de disque dur virtuel stocké dans $VMDK.

Exemple 3 : Spécifier un propriétaire pour tous les disques durs virtuels avec un propriétaire « Inconnu »

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

Cette commande obtient tous les objets de disque dur virtuel de la bibliothèque VMM dont le propriétaire est « Inconnu », puis spécifie un propriétaire pour chaque objet de disque dur virtuel.

Paramètres

-Description

Spécifie une description de l’objet de 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

-Enabled

Active un objet lorsqu’il est défini sur $True ou désactive un objet lorsqu’il est défini sur $False. Par exemple, si vous souhaitez mettre à niveau des logiciels sur un modèle de machine virtuelle, vous pouvez désactiver l’objet de modèle dans la bibliothèque VMM pour empêcher temporairement les utilisateurs d’utiliser cet objet.

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

-FamilyName

Spécifie un nom de famille pour une ressource physique dans la bibliothèque VMM. Cette valeur est utilisée conjointement avec Release, Namespace et Type pour établir l’équivalence entre les ressources de bibliothèque.

Type:String
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écute 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 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

-Name

Spécifie le nom d’un objet VMM.

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

-OperatingSystem

Spécifie le type de système d’exploitation d’une machine virtuelle. Pour répertorier les noms de tous les systèmes d’exploitation disponibles dans VMM, tapez Get-SCOperatingSystem.

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

-Owner

Spécifie le propriétaire d’un objet VMM sous la forme d’un compte d’utilisateur de domaine valide.

  • Exemple de format : -Owner "Contoso\PattiFuller"
  • Exemple de format : -Owner "PattiFuller@Contoso"
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

-ProductKey

Spécifie une clé de produit. La clé de produit est un numéro à 25 chiffres qui identifie la licence du produit. Une clé de produit peut être utilisée pour inscrire VMM ou un système d’exploitation à installer sur une machine virtuelle ou un hôte.

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

-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

-Release

Spécifie une chaîne qui décrit la mise en production d’une ressource de bibliothèque. VMM crée automatiquement une valeur de mise en production pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, la chaîne peut être personnalisée.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
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

-SharePath

Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin UNC (Universal Naming Convention).

Exemple de format : -SharePath "\\LibServer01\LibShare"

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

-Tag

Spécifie un mot ou une expression à associer à un objet afin que vous puissiez rechercher tous les objets avec l’ensemble spécifié de balises. Vous pouvez rechercher un sous-ensemble de balises ou rechercher l’ensemble complet des balises.

Type:System.Collections.Generic.List`1[System.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

-UserRole

Spécifie un objet de rôle d’utilisateur.

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

-VirtualHardDisk

Spécifie un objet de disque dur virtuel.

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

-VirtualHardDisks

Spécifie un tableau d’objets de disque dur virtuel.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VirtualizationPlatform

Spécifie la plateforme de virtualisation d’un hôte de machine virtuelle gérée par VMM. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • HyperV
  • VMwareESX
  • XENServer
Type:VirtualizationPlatform
Valeurs acceptées:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

VirtualHardDisk

Cette applet de commande retourne un objet VirtualHardDisk.

Notes

  • Nécessite un objet de disque dur virtuel VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualHardDisk .