Register-SCVirtualMachine
Regista uma máquina virtual existente com VMM que não está atualmente registada na plataforma de virtualização de qualquer hospedeiro gerido por VMM e não está armazenada na biblioteca VMM.
Syntax
Register-SCVirtualMachine
[-VMHost] <Host>
[-Path] <String>
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
O cmdlet Register-SCVirtualMachine regista uma máquina virtual existente com O Gestor de Máquinas Virtuais (VMM). Registe um anfitrião que não esteja atualmente registado na plataforma de virtualização de qualquer anfitrião gerido pela VMM, e que não esteja armazenado na biblioteca VMM. As plataformas de virtualização são Hyper-V, VMware e XenServer. Se os ficheiros de máquinas virtuais forem armazenados na biblioteca VMM, não terá de registar a máquina virtual antes de a implantar num hospedeiro.
Os ficheiros de configuração para a máquina virtual registar-se devem ser armazenados no sistema de ficheiros do anfitrião para implantar a máquina virtual ou armazenados em armazenamento partilhado disponível para este anfitrião.
Para registar uma máquina virtual para um anfitrião Hiper-V, os ficheiros de configuração dessa máquina virtual devem ser armazenados numa pasta no sistema de ficheiros do anfitrião ou no armazenamento partilhado. Além disso, deve criar uma exportação da máquina virtual utilizando o comando Export na consola Hyper-V Manager. O caminho deve especificar uma pasta.
Para registar uma máquina virtual para um anfitrião VMware ESX, a configuração VMware .vmx deve ser armazenada no sistema de ficheiros do anfitrião ou no armazenamento partilhado. Não existe um passo de exportação separado. O caminho deve especificar a pasta e o ficheiro de configuração.
Não utilize este cmdlet para registar máquinas virtuais num hospedeiro XenServer.
Exemplos
Exemplo 1: Registar uma máquina virtual existente num hospedeiro Hiper-V
PS C:\> $VMHost = Get-SCVMHost -ComputerName "HyperVHost01"
PS C:\> Register-SCVirtualMachine -VMHost $VMHost -Path "D:\HyperVFolderForVMs"
O primeiro comando recebe o objeto do anfitrião Hyper-V chamado HyperVHost01, e depois armazena esse objeto na variável $VMHost.
O segundo comando adiciona a máquina virtual existente em HVHost02 a VMM especificando o caminho da pasta que contém o ficheiro de configuração da máquina virtual.
Exemplo 2: Registar uma máquina virtual existente num anfitrião VMware ESX
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 anfitrião VMware ESX chamado ESXHost03, e armazena o objeto de anfitrião na variável $VMHost.
O segundo comando adiciona uma máquina virtual existente no ESXHost03 ao VMM especificando o caminho do ficheiro de configuração da máquina virtual da máquina virtual.
Parâmetros
-JobGroup
Especifica um identificador para uma série de comandos que funcionam como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.
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 ficheiro de configuração da máquina virtual para a máquina virtual que este cmdlet regista.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMHost
Especifica um objeto hospedeiro de máquina virtual. A VMM suporta anfitriões Hiper-V, anfitriões VMware ESX e anfitriões Citrix XenServer.
Para obter mais informações sobre cada tipo de hospedeiro, 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