Get-SCStorageVolume
Obtém um objeto de volume de armazenamento de um host gerenciado pelo VMM.
Sintaxe
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 Virtual Machine Manager (VMM).
As informações devolvidas incluem, entre outras, as seguintes:
Nome. O nome de cada volume de host (como C:, D:, E:\).
StorageVolumeID. O ID de volume (um GUID) para cada volume de host. O ID do volume do host é exclusivo em todo o 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.
Espaço Livre. A quantidade de espaço livre em cada volume.
VolumeLabel. Um rótulo definido pelo usuário para este 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 se existe um recurso de disco clusterizado para esse volume.
InUtilização. Um sinalizador que é 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 nesse host.
Conexão de servidor. A conexão do servidor VMM que está gerenciando o host ao qual esse volume pertence.
Identificação O 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.
Nota: Para traduzir a capacidade e o espaço livre de bytes em unidades de medida maiores, divida o número de bytes por 1024 para obter kilobytes (KB); dividir 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:\ de 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 de host do VMMServer01, seleciona apenas os objetos de host cuja plataforma de virtualização é VMware ESX e, em seguida, armazena esses objetos de host em $VMHost.
Nota: Este exemplo pressupõe que os nomes de todos os volumes nesses ESX Servers incluam a string "storage", mas que apenas alguns dos nomes desses volumes incluam a string "SharedStorage".
O segundo comando passa cada objeto de host ESX em $VMHost para o cmdlet Get-SCStorageVolume , que obtém os objetos de volume nesses hosts e, em seguida, 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 no qual 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.
Tipo: | LibraryServer |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-Name
Especifica o nome de um objeto do VMM.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-StorageArray
Especifica um objeto de matriz de armazenamento. Pode ser um subsistema de armazenamento Fibre Channel ou iSCSI usado para armazenar a configuração da máquina virtual e discos virtuais.
Tipo: | StorageArray |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-VMHost
Especifica um objeto de host de máquina virtual. O VMM suporta hosts Hyper-V, VMware ESX e Citrix XenServer.
Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .
Tipo: | Host |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
Tipo: | ServerConnection |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
Saídas
StorageVolume
Este cmdlet retorna um objeto StorageVolume .