Partilhar via

Move-SCVMHost

  • Referência
Módulo:
VirtualMachineManager

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 Virtual Machine Manager (VMM) de seu grupo de hosts atual para um novo grupo de hosts pai. Antes de poder mover um host, seu novo grupo de hosts pai deve existir.

Se o host for um computador gerenciado por membros de uma função de usuário Usuário Self-Service ou Administrador Delegado, mover o host de um grupo de hosts para outro pode afetar as funções que têm acesso ao host ou a 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 de 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 de 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 de 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 de host armazenado em $SpecificHosts para o grupo de hosts armazenado na variável $NewHG (NewHostGroup03).

Parâmetros

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ParentHostGroup

Especifica o grupo de hosts pai que contém um ou mais hosts, grupos de hosts ou clusters de hosts.

Tipo:HostGroup
Aliases:ParentVMHostGroup
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMHost

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

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

Tipo:Host
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Host

Este cmdlet retorna um objeto Host.

Notas

  • Requer um objeto de host do VMM, que pode ser recuperado usando o cmdlet Get-SCVMHost.