Compartilhar via

Get-SCVMMServer

  • Referência
Módulo:
VirtualMachineManager

Conecta-se a um servidor de gerenciamento do VMM se uma conexão ainda não existir ou se conectar a um servidor de gerenciamento do VMM diferente.

Syntax

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 VMM (Virtual Machine Manager) se uma conexão ainda não existir e recuperar 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ê criou uma conexão com um servidor de gerenciamento do VMM usando a interface do usuário (interface do usuário), ao 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 usando apenas o shell de comando do VMM, deverá usar o parâmetro SetAsDefault para manter a conexão de sessão a sessão ou se conectar novamente 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 serão executados na linha de comando do shell de comando do VMM que exigem que o objeto de servidor do VMM use automaticamente a conexão existente até que você feche a janela do shell de comando do VMM.

O serviço do VMM em execução no servidor de gerenciamento do VMM dá suporte ao banco 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 executando SQL Server.

O serviço do VMM permite que você gerencie seu ambiente virtual, incluindo servidores host (que hospedam máquinas virtuais), servidores de biblioteca (que armazenam recursos de 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: Conectar-se a um servidor VMM

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

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

Exemplo 2: Conectar-se a um servidor VMM por meio de uma porta específica

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

Esse comando se conecta pela porta TCP 8100 ao servidor do VMM chamado VMMServer01 localizado no domínio contoso.

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

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 do VMM chamado VMMServer01 e armazena o objeto na variável $VMMServer.

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

  • TypeName: o nome do tipo .NET do objeto de servidor do 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 ele redireciona a saída para o cmdlet Format-List para exibir a definição completa de cada método e cada propriedade para o objeto do servidor do VMM.

Exemplo 4: Conectar-se a um servidor do VMM diferente com uma função de usuário diferente

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

Esse comando se conecta ao servidor do 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.

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

-ComputerName

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

  • FQDN
  • Endereço IPv4 ou IPv6
  • Nome NetBIOS
Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 do shell de comando do VMM. Os valores aceitáveis para esse 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.

Type:Profile
Accepted values:Administrator, DelegatedAdmin, TenantAdmin, SelfServiceUser, ReadOnlyAdmin
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Executar como 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 Executar como, digite Get-Help New-SCRunAsAccount.

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

-ForOnBehalfOf

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

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

-RetainDeletedObjects

Especifica que os objetos no cache marcados para exclusão serão preservados. Talvez seja necessário esse parâmetro somente se você criar uma interface do usuário na parte superior do shell de comando do VMM.

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

-RetainObjectCache

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-TCPPort

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

Type:Int32
Aliases:Port
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRoleName

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

  • Administrador delegado
  • Administrador somente leitura
  • Usuário de autoatendimento
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False