Get-SCVMMServer

  • Referência
Módulo:
VirtualMachineManager

Conecta-se a um servidor de gestão VMM se uma ligação já não existir ou se ligar a um servidor de gestão 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 liga-se a um servidor de gestão virtual do Gestor de Máquinas (VMM) se já não existir uma ligação e recuperar o objeto do servidor a partir da base de dados VMM. A porta predefinida utilizada para ligar a um servidor VMM é a porta TCP 8100.

Se criou uma ligação a um servidor de gestão VMM utilizando a interface do utilizador (UI), quando abre uma concha de comando VMM, essa concha de comando liga-se automaticamente ao mesmo servidor de gestão VMM. Se não tiver anteriormente ligado ao servidor de gestão VMM utilizando o UI, tem de utilizar o Get-SCVMMServer para estabelecer uma ligação. Note que se ligar a um servidor de gestão VMM apenas utilizando o comando VMM, deve utilizar o parâmetro SetAsDefault para manter a ligação de sessão para sessão ou voltar a ligar ao servidor VMM sempre que abrir uma nova sessão de comando VMM.

Também pode utilizar o Get-VMMServer para ligar-se a um servidor de gestão VMM diferente.

Após a ligação ao servidor de gestão VMM, todos os comandos futuros são executados na linha de comando do comando do comando VMM que requerem o objeto do servidor VMM utilizarão automaticamente a ligação existente até fechar a janela do comando VMM.

O serviço VMM em execução no servidor de gestão VMM suporta a base de dados VMM. Esta base de dados é armazenada no Microsoft SQL Server quer no próprio servidor de gestão VMM, quer num servidor separado que executa SQL Server.

O serviço VMM permite-lhe gerir o seu ambiente virtual, incluindo servidores anfitriões (que acolhem máquinas virtuais), servidores de bibliotecas (que armazenam recursos da biblioteca VMM) e máquinas virtuais implantadas num hospedeiro ou armazenadas na biblioteca.

Para obter mais informações sobre a ligação ao servidor de gestão VMM, escreva 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 liga-se ao servidor VMM chamado VMMServer01 localizado no domínio Contoso e obtém o objeto do servidor a partir da base de dados 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 sobre a porta TCP 8100 ao servidor VMM chamado VMMServer01 localizado no domínio Contoso.

Exemplo 3: Ligue-se a um servidor VMM e obtenha o seu tipo, métodos e propriedades de objeto .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 do servidor VMM chamado VMMServer01 e armazena o objeto na variável $VMMServer.

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

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

  • Tipo de Membro: Uma lista que contém o nome e definição de cada evento, método e propriedade associada a este 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 Format-List cmdlet para exibir a definição completa para cada método e cada propriedade para o objeto do servidor VMM.

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

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

Este comando liga-se ao servidor VMM chamado VMMServer02 localizado no domínio Contoso utilizando a função de utilizador DelegadoAdmin.

Parâmetros

-AllowJobGC

Indica que a recolha 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 na sua rede. Os valores aceitáveis para este 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 utilizador VMM a utilizar, se o utilizador for membro de mais do que uma função, ao ligar-se ao servidor de gestão VMM a partir do invólucro de comando VMM. Os valores aceitáveis para este parâmetro são:

  • Administrador
  • DelegadoAdmin
  • ReadOnlyAdmin
  • SelfServiceUser

Os administradores VMM podem gerir todos os objetos VMM. Os administradores delegados e os utilizadores de self-service podem aceder e alterar apenas os objetos que estão dentro do âmbito das suas funções de utilizador. Read-Only administradores só podem ver as propriedades dos objetos existentes; não podem criar novos objetos ou alterar as propriedades dos 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 credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de utilizador e a palavra-passe de uma conta que tem permissão para realizar esta ação. Ou, no caso do Restart-SCJob, tem permissão para completar uma tarefa reiniciada.

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

Para mais informações sobre Run As accounts, escreva 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 utilizar os parâmetros OnBehalfOf , quando disponíveis, para cmdlets VMM. Este parâmetro é utilizado principalmente para ligações da Fundação service provider ao VMM.

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

-RetainDeletedObjects

Especifica que os objetos na cache marcados para eliminação serão preservados. Pode necessitar deste parâmetro apenas se criar uma interface de utilizador em cima da concha de comando VMM.

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

-RetainObjectCache

Indica que os objetos na cache permanecerão na memória e não serão recuperados pela recolha de lixo. Pode precisar deste parâmetro se criar uma interface de utilizador em cima da concha de comando VMM.

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

-SetAsDefault

Indica, quando definido para $True, que o comando VMM conecta-se ao servidor de gestão VMM especificado para esta sessão e mantém essa ligação para futuras sessões.

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 utilizador. Os tipos de funções de utilizador que são nomeados incluem:

  • Administrador Delegado
  • Administrador Só de Leitura
  • Self-Service Utilizador
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False