Move-SCVMHost
Move um host de máquina virtual gerenciado pelo VMM de um grupo de hosts para outro.
Sintaxe
Move-SCVMHost
[-VMHost] <Host>
-ParentHostGroup <HostGroup>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
O cmdlet Move-SCVMHost move um ou mais hosts de máquina virtual gerenciados pelo VMM (Virtual Machine Manager) de seu grupo de hosts atual para um novo grupo de hosts pai. Antes de mover um host, o novo grupo de hosts pai deve existir.
Se o host for um computador gerenciado por membros de uma função de usuário Self-Service Usuário ou Administrador Delegado, mover o host de um grupo de hosts para outro poderá afetar as funções que têm acesso ao host ou às máquinas virtuais nesse host.
Exemplos
Exemplo 1: mover um único host para um novo grupo de hosts pai
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01"
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup01"
PS C:\> Move-SCVMHost -VMHost $VMHost -ParentHostGroup $NewHG
O primeiro comando obtém o host chamado VMHost01 e o armazena na variável $VMHost.
O segundo comando obtém o objeto do grupo de hosts chamado NewHostGroup e o armazena na variável $NewHG.
O último comando move o host armazenado na variável $VMHost (VMHost01) para o grupo de hosts armazenado na variável $NewHG (NewHostGroup).
Exemplo 2: mover todos os hosts para um novo grupo de hosts pai
PS C:\> $AllHosts = Get-SCVMHost
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup02"
PS C:\> $AllHosts | Move-SCVMHost -ParentHostGroup $NewHG
O primeiro comando obtém todos os objetos host e os armazena na matriz $AllHosts.
O segundo comando obtém o grupo de hosts chamado NewHostGroup02 e o armazena na variável $NewHG.
O último comando move cada objeto host na matriz $AllHosts para o novo grupo de hosts pai armazenado na variável $NewHG (NewHostGroup02).
Exemplo 3: mover um conjunto de hosts de um grupo de hosts para um novo grupo de hosts pai
PS C:\> $SpecificHosts = Get-SCVMHost | where { $_.VMHostGroup -like "*OldGroup*" }
PS C:\> $NewHG = Get-SCVMHostGroup -Name "NewHostGroup03"
PS C:\> $SpecificHosts | Move-SCVMHost -ParentHostGroup $NewHG
O primeiro comando obtém todos os objetos host cujo grupo de hosts contém a cadeia de caracteres "OldGroup" e os armazena na variável $SpecificHosts.
O segundo comando obtém o grupo de hosts chamado NewHostGroup03 e o armazena na variável $NewHG.
O último comando move cada objeto host armazenado em $SpecificHosts para o grupo de hosts armazenado na variável $NewHG (NewHostGroup03).
Parâmetros
-JobVariable
Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ParentHostGroup
Especifica o grupo de hosts pai que contém um ou mais hosts, grupos de hosts ou clusters de host.
Tipo: | HostGroup |
Aliases: | ParentVMHostGroup |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-PROTipID
Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
Tipo: | Guid |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-VMHost
Especifica um objeto de 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.
Tipo: | Host |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
Saídas
Host
Esse cmdlet retorna um objeto Host.
Observações
- Requer um objeto host do VMM, que pode ser recuperado usando o cmdlet Get-SCVMHost
.