Partager via

Get-SCVirtualHardDisk

  • Référence
Module:
VirtualMachineManager

Obtient les objets de disque dur virtuel d’une machine virtuelle, d’un modèle ou en tant que fichier autonome stocké dans la bibliothèque VMM.

Syntaxe

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVirtualHardDisk obtient des objets de disque dur virtuel à partir d’une machine virtuelle, à partir d’un modèle ou en tant que fichier autonome stocké dans la bibliothèque Virtual Machine Manager (VMM).

Un disque dur virtuel peut être un fichier .vhd windows, un fichier .vhd basé sur Citrix XenServer ou un fichier VMware.vmdk. Un disque dur virtuel peut être stocké en tant qu’objet autonome dans la bibliothèque VMM, attaché à un lecteur de disque virtuel sur un modèle ou attaché à un lecteur de disque virtuel sur une machine virtuelle déployée ou stockée.

Exemples

Exemple 1 : Obtenir un objet de disque dur virtuel à partir de la bibliothèque

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

Cette commande obtient l’objet de disque dur virtuel nommé VHD01.vhd stocké sur LibraryServer01, puis stocke l’objet dans la variable $VHD.

Exemple 2 : Obtenir un objet de disque dur virtuel à partir d’une machine virtuelle

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

La première commande se connecte à VMMServer01.

La deuxième commande obtient l’objet de machine virtuelle nommé VM01, sélectionne tous les disques durs virtuels sur VM01 dont le nom inclut la chaîne « DataDisk », puis stocke les objets de disque dur virtuel retournés dans la variable $VHD.

Exemple 3 : Obtenir un objet de disque dur virtuel à partir d’un modèle spécifique

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

Cette commande obtient l’objet de modèle nommé Template01 à partir de la bibliothèque et affiche tous les objets de disque dur virtuel sur ce modèle.

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendamment de l’objet parent. Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet de modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-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

-ID

Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

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

-Name

Spécifie le nom d’un objet VMM.

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

-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

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

-VM

Spécifie un objet de machine virtuelle.

Type:VM
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-VMTemplate

Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.

Type:Template
Alias:Template
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

VirtualHardDisk

Cette applet de commande retourne un objet VirtualHardDisk.

Notes

  • Nécessite un objet de machine virtuelle VMM ou un objet de modèle VMM, qui peut être récupéré à l’aide de l’applet de commande Get-SCVirtualMachine , ou de l’applet de commande Get-SCVMTemplate Get-SCVMTemplate, respectivement.