Partager via


Get-SCVirtualDiskDrive

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

Syntaxe

All

Get-SCVirtualDiskDrive
    [-VMMServer <ServerConnection>]
    [-All]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

VM

Get-SCVirtualDiskDrive
    -VM <VM>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Template

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

ID

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

Description

L’applet de commande Get-SCVirtualDiskDrive récupère les objets d’unité de disque virtuel Virtual Machine Manager (VMM). Ces disques virtuels peuvent être configurés sur des modèles de machines virtuelles 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 récupère tous les lecteurs de disque virtuel liés à toutes les machines virtuelles enregistrées auprès de 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 récupère tous les objets de lecteur de disque virtuel sur VM02 et stocke ces objets dans $VirtDiskDrive. Si, comme le suppose cet exemple, une machine virtuelle contient plusieurs unités de disque virtuel, chaque unité de disque virtuel est connectée à un disque dur virtuel ou à un disque intermédiaire.

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 intermédiaires.

Exemple 3 : Compter les lecteurs de disque virtuels, à l’exception des disques relais

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 récupère les objets de lecteur de disque virtuel, à l’exclusion des disques interpassifs, qui sont connectés au deuxième emplacement de l’un ou l’autre canal IDE. L’utilisation du symbole @ et des parenthèses permet de s’assurer que la commande stocke les résultats dans un tableau, même si elle renvoie un seul objet 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 récupère 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 récupère tous les objets de lecteur de disque pour chaque modèle. Ensuite, la commande sélectionne uniquement les objets d’unité 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 la LUN pour chaque objet d’unité 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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

All
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ID

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

Propriétés du paramètre

Type:Guid
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

ID
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:UserRole
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VM

Spécifie un objet de machine virtuelle à partir duquel cette applet de commande obtient des lecteurs de disque virtuel.

Propriétés du paramètre

Type:VM
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

VM
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMMServer

Spécifie un objet serveur VMM.

Propriétés du paramètre

Type:ServerConnection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-VMTemplate

Spécifie un objet modèle VMM utilisé pour créer des machines virtuelles contenant des lecteurs de disque virtuel que cette applet de commande obtient.

Propriétés du paramètre

Type:Template
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Modèle

Jeux de paramètres

Template
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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 .