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 .