Get-SCStorageVolume

  • Referência
Módulo:
VirtualMachineManager

Obtém um objeto de volume de armazenamento de um host gerenciado pelo 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

O cmdlet Get-SCStorageVolume obtém um ou mais objetos de volume de armazenamento de um host gerenciado pelo VMM (Virtual Machine Manager).

As informações retornadas incluem, mas não se limitam a:

  • Nome. O nome de cada volume de host (como C:, D:, E:\).

  • StorageVolumeID. A ID do volume (um GUID) para cada volume de host. A ID do volume do host é exclusiva em seu ambiente do VMM.

  • MountPoints. Os pontos de montagem para cada volume. Um único volume, como C:, pode conter vários pontos de montagem.

  • Capacidade. A capacidade de armazenamento de cada volume.

  • Freespace. A quantidade de espaço livre em cada volume.

  • VolumeLabel. Um rótulo definido pelo usuário para esse volume (se houver).

  • IsSANMigrationPossible. Um sinalizador que indica se a migração de SAN está disponível ou não.

  • IsClustered - Um sinalizador que indica se o volume é armazenamento local ou armazenamento compartilhado (ou seja, usa armazenamento externo, como SAN ou iSCSI) e existe um recurso de disco clusterizado para esse volume.

  • InUse. Um sinalizador definido como True quando uma das máquinas virtuais altamente disponíveis gerenciadas pelo VMM está usando esse volume.

  • Vmhost. O nome FQDN do host no qual cada volume reside.

  • IsAvailableForPlacement. Um sinalizador que indica se esse volume está disponível como um local no qual implantar máquinas virtuais neste host.

  • Serverconnection. A conexão do servidor VMM que está gerenciando o host ao qual esse volume pertence.

  • ID. A ID (um GUID) para cada volume.

Exemplos

Exemplo 1: Obter todos os volumes no servidor host especificado

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

O primeiro comando obtém o objeto host chamado VMHost01 e armazena o objeto na variável $VMHost.

O segundo comando obtém todos os objetos de volume de unidade do VMHost01 e exibe informações sobre esses volumes para o usuário.

Observação: para traduzir a capacidade e o espaço livre de bytes em unidades maiores de medida, divida o número de bytes por 1024 para obter quilobytes (KB); divida o resultado por 1024 para obter megabytes (MB); e divida esse resultado por 1024 para obter gigabytes (GB).

Exemplo 2: Obter o volume especificado em um host

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

O primeiro comando obtém o objeto host chamado VMHost02 e armazena o objeto na variável $VMHost.

O segundo comando obtém o volume da unidade chamado C:\ do VMHost02 e exibe informações sobre esse volume para o usuário.

Exemplo 3: Obter todos os volumes em hosts VMware ESX que contêm a cadeia de caracteres "SharedStorage" no nome do 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" }

O primeiro comando obtém todos os objetos host do VMMServer01, seleciona apenas os objetos host cuja plataforma de virtualização é o VMware ESX e armazena esses objetos host em $VMHost.

Observação: este exemplo pressupõe que os nomes de todos os volumes nesses servidores ESX incluam a cadeia de caracteres "storage", mas que apenas alguns dos nomes desses volumes incluem a cadeia de caracteres "SharedStorage".

O segundo comando passa cada objeto host ESX em $VMHost para o cmdlet Get-SCStorageVolume , que obtém os objetos de volume nesses hosts e, por sua vez, passa os objetos de volume para "select" (o alias para o cmdlet Select-Object ). O cmdlet Select-Object exibe o nome do volume e o host em que o volume reside para os volumes cujo nome contém a cadeia de caracteres "SharedStorage".

Parâmetros

-LibraryServer

Especifica um objeto de servidor de biblioteca do VMM.

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

-Name

Especifica o nome de um objeto do VMM.

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

-StorageArray

Especifica um objeto de matriz de armazenamento. Pode ser um subsistema de armazenamento fibre channel ou iSCSI que é usado para armazenar a configuração de máquina virtual e discos virtuais.

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

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts VMware ESX e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

StorageVolume

Este cmdlet retorna um objeto StorageVolume .