Register-SCVirtualMachine
Registra uma máquina virtual existente com o VMM que atualmente não está registrado na plataforma de virtualização de qualquer host gerenciado pelo VMM e não é armazenado na biblioteca do VMM.
Syntax
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
O cmdlet Register-SCVirtualMachine registra uma máquina virtual existente com o VMM (Virtual Machine Manager). Registre um host que não esteja registrado atualmente na plataforma de virtualização de qualquer host gerenciado pelo VMM e não esteja armazenado na biblioteca do VMM. As plataformas de virtualização são Hyper-V, VMware e XenServer. Se os arquivos de máquina virtual forem armazenados na biblioteca do VMM, você não precisará registrar a máquina virtual antes de implantá-la em um host.
Os arquivos de configuração da máquina virtual a serem registrados devem ser armazenados no sistema de arquivos no host no qual a máquina virtual deve ser implantada ou armazenada no armazenamento compartilhado disponível para esse host.
Para registrar uma máquina virtual para um host Hyper-V, os arquivos de configuração dessa máquina virtual devem ser armazenados em uma pasta no sistema de arquivos do host ou no armazenamento compartilhado. Além disso, você deve criar uma exportação da máquina virtual usando o comando Exportar no console do Gerenciador do Hyper-V. O caminho deve especificar uma pasta.
Para registrar uma máquina virtual para um host VMware ESX, a configuração do VMware .vmx deve ser armazenada no sistema de arquivos do host ou no armazenamento compartilhado. Não há nenhuma etapa de exportação separada. O caminho deve especificar a pasta e o arquivo de configuração.
Não use esse cmdlet para registrar máquinas virtuais em um host XenServer.
Exemplos
Exemplo 1: registrar uma máquina virtual existente em um host Hyper-V
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"O primeiro comando obtém o objeto host Hyper-V chamado HyperVHost01 e armazena esse objeto na variável $VMHost.
O segundo comando adiciona a máquina virtual existente no HVHost02 ao VMM especificando o caminho da pasta que contém o arquivo de configuração da máquina virtual.
Exemplo 2: Registrar uma máquina virtual existente em um host ESX do VMware
PS C:\> $VMHost = Get-VMHost -ComputerName "ESXHost03"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "[storage1]\VMwareFolderForVMs\MyVM.vmx"O primeiro comando obtém o objeto que representa um host ESX do VMware chamado ESXHost03 e armazena esse objeto de host na variável $VMHost.
O segundo comando adiciona uma máquina virtual existente no ESXHost03 ao VMM especificando o caminho do arquivo de configuração da máquina virtual da máquina virtual.
Parâmetros
-JobGroup
Especifica um identificador para uma série de comandos executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho executado.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica o nome de uma variável na qual acompanhar e armazenar o progresso do trabalho.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica o caminho do arquivo de configuração da máquina virtual para a máquina virtual que esse cmdlet registra.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| 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 |
-VMHost
Especifica um objeto host de máquina virtual. O VMM dá suporte a hosts Hyper-V, hosts ESX VMware 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
VirtualMachine