Register-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

Associa um host VMware ESX ao VMM como um host de máquina virtual e especifica as credenciais para gerenciar o host.

Syntax

Register-SCVMHost
        [-VMHost] <Host>
        [-Credential <VMMCredential>]
        [-TCPPort <UInt32>]
        [-Certificate <ClientCertificate>]
        [-SshTcpPort <UInt32>]
        [-SshPublicKey <ClientSshPublicKey>]
        [-SshPublicKeyFile <String>]
        [-RunAsynchronously]
        [-PROTipID <Guid>]
        [-JobVariable <String>]
        [<CommonParameters>]

Description

O cmdlet Register-SCVMHost associa um host VMware ESX ao VMM (Virtual Machine Manager) como um host de máquina virtual e especifica as credenciais a serem usadas com esse host ESX.

Exemplos

Exemplo 1: Definir as credenciais para um host VMware ESX específico

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "ESX Host Computer Acct"
PS C:\> $ESXHost = Get-SCVMHost -ComputerName "ESXHost02.Contoso.com"
PS C:\> Register-SCVMHost -VMHost $ESXHost -Credential $RunAsAccount

O primeiro comando obtém o objeto de conta Executar como chamado ESX Host Computer Acct e armazena o objeto na variável $RunAsAccount.

O segundo comando obtém o objeto host ESX chamado ESXHost02 e armazena o objeto na variável $ESXHost.

O último comando associa o host VMware ESX ao VMM como um host gerenciado e especifica que a conta Executar como armazenada em $Credential deve ser usada para acessar o ESXHost02.

Exemplo 2: Definir as credenciais e o certificado para um host VMware ESX específico

PS C:\> $RunAsAccount = Get-SCRunAsAccount -Name "ESX Host Computer Acct"
PS C:\> $ESXHost = Get-SCVMHost -ComputerName "ESXHost03.contoso.com"
PS C:\> $Cert = Get-SCCertificate -ComputerName "ESXHost03.contoso.com"
PS C:\> Register-SCVMHost -VMHost $ESXHost -Credential $RunAsAccount -Certificate $Cert

O primeiro comando obtém o objeto de conta Executar como chamado ESX Host Computer Acct e armazena o objeto na variável $RunAsAccount. As credenciais necessárias para essa operação são uma conta raiz (raiz/<senha>) ou a conta do administrador delegado do VMware definida anteriormente no VirtualCenter Server para este host ESX.

O segundo comando obtém o objeto host ESX do VMware chamado ESXHost03 e armazena o objeto na variável $ESXHost.

O terceiro comando usa o cmdlet Get-SCCertificate para obter o objeto de certificado do ESXHost02 e armazena o objeto na variável $Cert.

O último comando associa esse VMware ESX Server ao VMM como um host gerenciado e especifica que as credenciais usadas para acessar o ESXHost02 são aquelas armazenadas em $RunAsAccount.

Parâmetros

-Certificate

Especifica um objeto de certificado de segurança.

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

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-SshPublicKey

Especifica a chave pública usada pelas comunicações do Secure Shell (SSH).

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

-SshPublicKeyFile

Especifica o caminho para o arquivo de chave pública para estabelecer um canal SSH seguro com os hosts de destino.

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

-SshTcpPort

Especifica o número da porta TCP usado pelo protocolo SSH.

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

-VMHost

Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts VMware ESX e hosts Citrix XenServer.

Para obter mais informações sobre cada tipo de host, consulte o cmdlet Add-SCVMHost .

Type:Host
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Saídas

Host

Esse cmdlet retorna um objeto Host .