Partilhar via

Get-SCVirtualMachine

Módulo:
VirtualMachineManager Module

Obtém objetos de máquina virtual.

Sintaxe

All (Predefinição) 

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

VMHostGroup 

Get-SCVirtualMachine
    [[-Name] <String>]
    -VMHost <Host>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Cloud 

Get-SCVirtualMachine
    [[-Name] <String>]
    -Cloud <Cloud>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

Service 

Get-SCVirtualMachine
    [[-Name] <String>]
    -Service <Service>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ComputerTier 

Get-SCVirtualMachine
    [[-Name] <String>]
    -ComputerTier <ComputerTier>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

StorageQoSPolicy 

Get-SCVirtualMachine
    [[-Name] <String>]
    -StorageQoSPolicy <StorageQoSPolicy>
    [-VMMServer <ServerConnection>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

ID 

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

Description

O cmdlet Get-SCVirtualMachine obtém um ou mais objetos de máquina virtual do banco de dados do Virtual Machine Manager (VMM). Este cmdlet obtém máquinas virtuais que são implantadas em um host de máquina virtual ou armazenadas na biblioteca do VMM.

Exemplos

Exemplo 1: Obter todas as máquinas virtuais e exibir informações sobre cada uma delas

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com"

Este comando obtém todos os objetos de máquina virtual no VMMServer01 e exibe informações sobre esses objetos de máquina virtual.

Exemplo 2: Obter todas as máquinas virtuais e exibir informações sobre propriedades específicas

PS C:\> Get-SCVirtualMachine -VMMServer "VMMServer01.Contoso.com" | Format-List -Property Name, Owner, Description, HostName, OperatingSystem, CPUCount, Memory

Este comando obtém todos os objetos de máquina virtual no VMMServer01 e exibe os valores das propriedades especificadas.

Exemplo 3: Obter uma máquina virtual pelo nome armazenada em um servidor de biblioteca especificado

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine | Where-Object { $_.Name -Eq "VM02" -And $_.LibraryServer -Eq "LibraryServer01" } | Select-Object Name,LibraryServer,Status

O primeiro comando se conecta ao VMMServer01.

O segundo comando obtém o objeto de máquina virtual chamado VM02 armazenado em LibraryServer01 e, em seguida, exibe o nome da máquina virtual, o nome do servidor de biblioteca e o status da máquina virtual.

Exemplo 4: Obter todas as máquinas virtuais no host especificado

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> Get-SCVirtualMachine -VMHost "VMHost01.Contoso.com"

O primeiro comando se conecta ao VMMServer01.

O segundo comando obtém todos os objetos de máquina virtual implantados no VMHost01 e exibe informações sobre essas máquinas virtuais.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

All
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Cloud

Especifica um objeto de nuvem privada.

Propriedades dos parâmetros

Tipo:Cloud
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Cloud
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ComputerTier

Especifica um objeto de camada de computador.

Propriedades dos parâmetros

Tipo:ComputerTier
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ComputerTier
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ID

Especifica a ID exclusiva de um objeto.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ID
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole . Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Propriedades dos parâmetros

Tipo:UserRole
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Service

Especifica um objeto de serviço do VMM.

Propriedades dos parâmetros

Tipo:Service
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Service
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageQoSPolicy

Especifica a política de Qualidade de Serviço (QoS) para as máquinas virtuais obtidas por esse cmdlet.

Propriedades dos parâmetros

Tipo:StorageQoSPolicy
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

StorageQoSPolicy
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 .

Propriedades dos parâmetros

Tipo:Host
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

VMHostGroup
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

Tipo:ServerConnection
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

VirtualMachine

Este cmdlet retorna um objeto VirtualMachine .