Partager via

Get-SCStorageVolume

  • Référence
Module:
VirtualMachineManager

Obtient un objet de volume de stockage d’un hôte géré par VMM.

Syntax

Get-SCStorageVolume
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -LibraryServer <LibraryServer>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -StorageArray <StorageArray>
   [[-Name] <String>]
   [<CommonParameters>]
Get-SCStorageVolume
   -VMHost <Host>
   [[-Name] <String>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCStorageVolume obtient un ou plusieurs objets de volume de stockage d’un hôte géré par Virtual Machine Manager (VMM).

Les informations retournées incluent, mais elles ne sont pas limitées aux éléments suivants :

  • Nom. Nom de chaque volume hôte (par exemple, C:, D:, E:\).

  • StorageVolumeID. ID de volume (GUID) pour chaque volume hôte. L’ID de volume hôte est unique dans votre environnement VMM.

  • Points de montage. Points de montage pour chaque volume. Un seul volume, tel que C:, peut contenir plusieurs points de montage.

  • Capacité. Capacité de stockage de chaque volume.

  • Freespace. Quantité d’espace libre sur chaque volume.

  • VolumeLabel. Étiquette définie par l’utilisateur pour ce volume (le cas échéant).

  • IsSANMigrationPossible. Indicateur indiquant si la migration SAN est disponible ou non.

  • IsClustered : indicateur indiquant si le volume est un stockage local ou un stockage partagé (autrement dit, utilise un stockage externe, tel que SAN ou iSCSI) et une ressource de disque en cluster existe pour ce volume.

  • Inuse. Indicateur défini sur True lorsque l’une des machines virtuelles hautement disponibles gérées par VMM utilise ce volume.

  • VMHost. Nom de domaine complet de l’hôte sur lequel se trouve chaque volume.

  • IsAvailableForPlacement. Indicateur indiquant si ce volume est disponible en tant qu’emplacement sur lequel déployer des machines virtuelles sur cet hôte.

  • Serverconnection. Connexion de serveur VMM qui gère l’hôte auquel ce volume appartient.

  • ID. ID (un GUID) pour chaque volume.

Exemples

Exemple 1 : Obtenir tous les volumes sur le serveur hôte spécifié

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> Get-SCStorageVolume -VMHost $VMHost

La première commande obtient l’objet hôte nommé VMHost01 et stocke l’objet dans la variable $VMHost.

La deuxième commande obtient tous les objets de volume de lecteur de VMHost01 et affiche des informations sur ces volumes à l’utilisateur.

Remarque : Pour traduire la capacité et l’espace libre des octets en unités de mesure supérieures, divisez le nombre d’octets de 1024 pour obtenir des kilo-octets (Ko) ; diviser le résultat par 1024 pour obtenir des mégaoctets (Mo) ; et divisez ce résultat de 1024 pour obtenir des gigaoctets (Go).

Exemple 2 : Obtenir le volume spécifié sur un hôte

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02.Contoso.com" 
PS C:\> Get-SCStorageVolume -VMHost $VMHost -Name "C:\"

La première commande obtient l’objet hôte nommé VMHost02 et stocke l’objet dans la variable $VMHost.

La deuxième commande obtient le volume de lecteur nommé C:\ de VMHost02 et affiche des informations sur ce volume à l’utilisateur.

Exemple 3 : Obtenir tous les volumes sur les hôtes VMware ESX qui contiennent la chaîne « SharedStorage » dans le nom du volume

PS C:\> $VMHost = Get-SCVMHost -VMMServer "VMMServer01.Contoso.com" | where { $_.VirtualizationPlatform -eq "VMwareESX" }
PS C:\> $VMHost | Get-SCStorageVolume | select -Property Name, VMHost | where { $_.Name -match "SharedStorage" }

La première commande obtient tous les objets hôtes de VMMServer01, sélectionne uniquement les objets hôtes dont la plateforme de virtualisation est VMware ESX, puis stocke ces objets hôtes dans $VMHost.

Remarque : cet exemple suppose que les noms de tous les volumes sur ces serveurs ESX incluent la chaîne « stockage », mais que seuls certains noms de ces volumes incluent la chaîne « SharedStorage ».

La deuxième commande transmet chaque objet hôte ESX dans $VMHost à l’applet de commande Get-SCStorageVolume , qui obtient les objets de volume sur ces hôtes, puis transmet les objets de volume à « select » (alias de l’applet de commande Select-Object ). L’applet de commande Select-Object affiche le nom du volume et l’hôte sur lequel réside ce volume pour ces volumes dont le nom contient la chaîne « SharedStorage ».

Paramètres

-LibraryServer

Spécifie un objet partage de bibliothèque VMM.

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

-Name

Spécifie le nom d’un objet VMM.

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

-StorageArray

Spécifie un objet de tableau de stockage. Il peut s’agir d’un sous-système de stockage Fibre Channel ou iSCSI utilisé pour stocker la configuration des machines virtuelles et les disques virtuels.

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

-VMHost

Spécifie un objet ordinateur hôte d’ordinateur virtuel. VMM prend en charge les hôtes Hyper-V, les hôtes VMware ESX et les hôtes Citrix XenServer.

Pour plus d’informations sur chaque type d’hôte, consultez l’applet de commande Add-SCVMHost .

Type:Host
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

Sorties

StorageVolume

Cette applet de commande retourne un objet StorageVolume .