Get-SCVirtualHardDisk

Référence

Module:: VirtualMachineManager

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

Syntax

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, 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 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 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 disque dur virtuel nommé VHD01.vhd stocké sur LibraryServer01, puis stocke l’objet dans la variable $VHD.

Exemple 2 : Obtenir un objet 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 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épendants 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 modèle auquel chaque objet de lecteur de disque virtuel est associé.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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, Espace de noms et Type pour établir l’équivalence entre les ressources de la bibliothèque.

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

-ID

Spécifie l’identificateur numérique comme identificateur global unique ou GUID pour un objet spécifique.

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

-Name

Spécifie le nom d’un objet VMM.

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

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

-VM

Spécifie un objet ordinateur virtuel.

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

-VMMServer

Spécifie un objet serveur VMM.

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

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des ordinateurs virtuels.

Type:	Template
Aliases:	Template
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 , respectivement.