Partilhar via

Get-SCVMMServer

  • Referência
Módulo:
VirtualMachineManager

Liga-se a um servidor de gestão do VMM se ainda não existir uma ligação ou liga-se a um servidor de gestão do VMM diferente.

Sintaxe

Get-SCVMMServer
   [-ComputerName] <String>
   [-TCPPort <Int32>]
   [-ConnectAs <Profile>]
   [-UserRoleName <String>]
   [-Credential <PSCredential>]
   [-RetainObjectCache]
   [-RetainDeletedObjects]
   [-AllowJobGC]
   [-SetAsDefault]
   [-ForOnBehalfOf]
   [<CommonParameters>]

Description

O cmdlet Get-SCVMMServer se conecta a um servidor de gerenciamento do Virtual Machine Manager (VMM) se ainda não existir uma conexão e recupera o objeto de servidor do banco de dados do VMM. A porta padrão usada para se conectar a um servidor VMM é a porta TCP 8100.

Se você tiver criado uma conexão com um servidor de gerenciamento do VMM usando a interface do usuário (UI), quando você abrir um shell de comando do VMM, esse shell de comando se conectará automaticamente ao mesmo servidor de gerenciamento do VMM. Se você não tiver se conectado anteriormente ao servidor de gerenciamento do VMM usando a interface do usuário, precisará usar Get-SCVMMServer para estabelecer uma conexão. Observe que, se você se conectar a um servidor de gerenciamento do VMM somente usando o shell de comando do VMM, deverá usar o parâmetro SetAsDefault para manter a conexão de sessão para sessão ou se reconectar ao servidor do VMM sempre que abrir uma nova sessão do shell de comando do VMM.

Você também pode usar Get-VMMServer para se conectar a um servidor de gerenciamento do VMM diferente.

Depois que uma conexão com o servidor de gerenciamento do VMM for estabelecida, todos os comandos futuros executados na linha de comando do shell de comando do VMM que exigem o objeto do servidor VMM usarão automaticamente a conexão existente até que você feche essa janela do shell de comando do VMM.

O serviço do VMM em execução no servidor de gestão do VMM suporta a base de dados do VMM. Esse banco de dados é armazenado no Microsoft SQL Server no próprio servidor de gerenciamento do VMM ou em um servidor separado que executa o SQL Server.

O serviço VMM permite gerenciar seu ambiente virtual, incluindo servidores host (que hospedam máquinas virtuais), servidores de biblioteca (que armazenam recursos da biblioteca do VMM) e máquinas virtuais implantadas em um host ou armazenadas na biblioteca.

Para obter mais informações sobre como se conectar ao servidor de gerenciamento do VMM, digite Get-Help about_VMM_2016_Connecting_to_the_VMM_Server.

Exemplos

Exemplo 1: Ligar a um servidor VMM

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

Este comando se conecta ao servidor VMM chamado VMMServer01 localizado no domínio Contoso e obtém o objeto de servidor do banco de dados do VMM.

Exemplo 2: Ligar a um servidor VMM através de uma porta específica

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com" -TCPPort 8100

Este comando liga-se através da porta TCP 8100 ao servidor VMM denominado VMMServer01 localizado no domínio Contoso.

Exemplo 3: Conectar-se a um servidor VMM e obter seu tipo de objeto, métodos e propriedades .NET

PS C:\> $VMMServer = Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VMMServer | Get-Member
PS C:\> $VMMServer | Get-Member | Format-List

O primeiro comando obtém o objeto de servidor VMM chamado VMMServer01 e armazena o objeto na variável $VMMServer.

O segundo comando passa o objeto de servidor VMM armazenado no $VMMServer para o cmdlet Get-Member, que recupera e exibe o seguinte:

  • TypeName: O nome do tipo .NET do objeto de servidor VMM: Microsoft.SystemCenter.VirtualMachineManager.Remoting.ServerConnection

  • MemberType: Uma lista que contém o nome e a definição de cada evento, método e propriedade associados a esse tipo de objeto.

O terceiro comando recupera e exibe as mesmas informações que o segundo comando, exceto que canaliza a saída para o cmdlet Format-List para exibir a definição completa para cada método e cada propriedade para o objeto de servidor VMM.

Exemplo 4: Ligar a um servidor VMM diferente com uma função de utilizador diferente

PS C:\> Get-SCVMMServer -ComputerName "VMMServer02.Contoso.com" -ConnectAs "DelegatedAdmin"

Este comando se conecta ao servidor VMM chamado VMMServer02 localizado no domínio Contoso usando a função de usuário DelegatedAdmin.

Parâmetros

-AllowJobGC

Indica que a coleta de lixo é permitida para trabalhos.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente na rede. Os valores aceitáveis para este parâmetro são:

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ConnectAs

Especifica a função de usuário do VMM a ser usada, se o usuário for membro de mais de uma função, ao se conectar ao servidor de gerenciamento do VMM a partir do shell de comando do VMM. Os valores aceitáveis para este parâmetro são:

  • Administrador
  • DelegatedAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

Os administradores do VMM podem gerenciar todos os objetos do VMM. Administradores delegados e usuários de autoatendimento podem acessar e alterar somente os objetos que estão dentro do escopo de suas funções de usuário. Read-Only administradores só podem exibir as propriedades de objetos existentes; Eles não podem criar novos objetos ou alterar as propriedades de objetos existentes.

Tipo:Profile
Valores aceites:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso de Restart-SCJob , tem permissão para concluir uma tarefa reiniciada.

Para obter mais informações sobre o objeto PSCredential, digite Get-Help Get-Credential.

Para obter mais informações sobre contas Run As, digite Get-Help New-SCRunAsAccount.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ForOnBehalfOf

Indica que um administrador pode usar parâmetros OnBehalfOf, quando disponíveis, para cmdlets do VMM. Esse parâmetro é usado principalmente para conexões do Service Provider Foundation com o VMM.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RetainDeletedObjects

Especifica que os objetos no cache marcados para exclusão serão preservados. Você pode precisar desse parâmetro somente se criar uma interface do usuário sobre o shell de comando do VMM.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RetainObjectCache

Indica que os objetos no cache permanecerão na memória e não serão recuperados pela coleta de lixo. Você pode precisar desse parâmetro se criar uma interface do usuário sobre o shell de comando do VMM.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SetAsDefault

Indica, quando definido como $True, que o shell de comando do VMM se conecta ao servidor de gerenciamento do VMM especificado para esta sessão e mantém essa conexão para sessões futuras.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TCPPort

Especifica um valor numérico que representa uma porta TCP.

Tipo:Int32
Aliases:Port
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRoleName

Especifica o nome de uma função de usuário. Os tipos de funções de usuário nomeados incluem:

  • Administrador Delegado
  • Administrador Read-Only
  • Self-Service Utilizador
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False