Partager via

Get-SCVirtualDiskDrive

  • Référence
Module:
VirtualMachineManager

Obtient des lecteurs de disque virtuel sur un modèle de machine virtuelle ou sur une machine virtuelle.

Syntax

Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCVirtualDiskDrive
   [-VMMServer <ServerConnection>]
   [-ID] <Guid>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCVirtualDiskDrive obtient des objets de lecteur de disque virtuel VMM (Virtual Machine Manager). Ces lecteurs de disque virtuel peuvent être configurés sur des modèles de machine virtuelle stockés dans la bibliothèque, ou sur des machines virtuelles déployées sur un hôte ou stockées dans la bibliothèque.

Exemples

Exemple 1 : Obtenir tous les lecteurs de disque virtuel dans votre environnement VMM

PS C:\> Get-SCVirtualDiskDrive -VMMServer "VMMServer01.Contoso.com" -All

Cette commande obtient tous les lecteurs de disque virtuel liés à toutes les machines virtuelles inscrites à VMM sur VMMServer01. La commande affiche des informations sur chaque lecteur de disque virtuel.

Exemple 2 : Obtenir des lecteurs de disque virtuel pour une machine virtuelle

PS C:\> $VM = Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Where-Object {$_.Name -Eq "VM02"} 
PS C:\> $VirtDiskDrive = Get-SCVirtualDiskDrive -VM $VM
PS C:\> $VirtDiskDrive

La première commande obtient l’objet de machine virtuelle nommé VM02 à l’aide de l’applet de commande Get-SCVirtualMachine . La commande stocke cet objet dans la variable $VM.

La deuxième commande obtient tous les objets de lecteur de disque virtuel sur VM02 et stocke ces objets dans $VirtDiskDrive. Si, comme le suppose cet exemple, un ordinateur virtuel contient plusieurs lecteurs de disque virtuel, chaque lecteur de disque virtuel se trouve connecté à un disque dur virtuel ou à un disque direct.

La dernière commande affiche les propriétés de chaque lecteur de disque virtuel sur VM02. Ces informations incluent le nom de tous les disques durs virtuels et le chemin d’accès du lecteur physique sur l’hôte pour tous les disques pass-through.

Exemple 3 : Compter les lecteurs de disque virtuel, à l’exception des disques pass-through

PS C:\> $VirtDiskDrive = @(Get-SCVirtualDiskDrive -All | Where-Object {$_.BusType -Eq "IDE" -And $_.PassThroughDisk -Eq $Null -And $_.LUN -Eq 1 -And ($_.Bus -Eq 0 -Or $_.Bus -Eq 1)})
PS C:\> $VirtDiskDrive.Count

La première commande obtient les objets de lecteur de disque virtuel, à l’exclusion des disques pass-through, qui sont connectés au deuxième emplacement de l’un ou l’autre canal IDE. L’utilisation du symbole @ et des parenthèses garantit que la commande stocke les résultats dans un tableau même si la commande retourne un objet unique ou une valeur $Null.

La deuxième commande affiche le nombre d’objets de lecteur de disque virtuel qui correspondent aux critères de filtre.

Exemple 4 : Obtenir des lecteurs de disque virtuel pour tous les modèles de machine virtuelle

PS C:\> $Templates = @(Get-SCVMTemplate)
PS C:\> $Templates | ForEach-Object {Get-SCVirtualDiskDrive -Template $_ | Where-Object {$_.BusType -Eq "IDE"}} | Format-List Name,BusType,Bus,LUN

La première commande obtient tous les modèles de machine virtuelle, puis stocke ces objets dans le tableau $Templates.

La deuxième commande transmet chaque objet de modèle de machine virtuelle stocké dans $Templates à l’applet de commande ForEach-Object. Cette applet de commande obtient tous les objets de lecteur de disque pour chaque modèle. Ensuite, la commande sélectionne uniquement les objets de lecteur de disque virtuel qui utilisent un type de bus IDE et transmet ces objets à l’applet de commande Format-List, qui affiche le nom, le type de bus, le bus et l’unité logique pour chaque objet de lecteur de disque virtuel.

Paramètres

-All

Indique que cette applet de commande récupère une liste complète de tous les objets de lecteur de disque virtuel indépendamment de l’objet parent.

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

-ID

Spécifie l’ID unique du lecteur de disque virtuel que cette applet de commande obtient.

Type:Guid
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

-VM

Spécifie un objet de machine virtuelle à partir duquel cette applet de commande obtient des lecteurs de disque 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 de modèle VMM utilisé pour créer des machines virtuelles contenant des lecteurs de disque virtuel que cette applet de commande obtient.

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

Sorties

VirtualDiskDrive

Cette applet de commande retourne un objet VirtualDiskDrive .

Notes

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