Move-SCVMHostGroup

  • Referência
Módulo:
VirtualMachineManager

Move um grupo de host do local atual para um novo local em um pai de grupo de host diferente.

Syntax

Move-SCVMHostGroup
    [-VMHostGroup] <HostGroup>
    [-JobGroup <Guid>]
    -ParentHostGroup <HostGroup>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Move-SCVMHostGroup move um ou mais objetos de grupo de host, que contêm hosts de máquina virtual gerenciados pelo VMM (Virtual Machine Manager), do local atual para um novo local em um pai de grupo de host diferente. Você pode colocar grupos de host no grupo de host raiz padrão (Todos os Hosts) ou em qualquer outro grupo de host criado por um administrador.

Todos os hosts dentro de um grupo de host movido adquirem um novo caminho de host em relação ao grupo de host raiz. Alterar a estrutura de grupos de host pode alterar quais funções de usuário de autoatendimento ou administrador delegado têm acesso aos hosts contidos nos grupos de host afetados ou às máquinas virtuais implantadas nesses hosts.

Exemplos

Exemplo 1: mover um grupo de host para um novo grupo de host pai

PS C:\> $OldHostGroup = Get-SCVMHostGroup -Name "OldHostGroup"
PS C:\> $NewHostGroup = Get-SCVMHostGroup -Name "NewHostGroup"
PS C:\> Move-SCVMHostGroup -VMHostGroup $OldHostGroup -ParentHostGroup $NewHostGroup

O primeiro comando obtém o grupo de host chamado OldHostGroup e armazena o objeto do grupo de host na variável $OldHostGroup.

O segundo comando obtém o grupo de host chamado NewHostGroup e armazena esse objeto de grupo de host na variável $NewHostGroup.

O último comando move o grupo de host armazenado na variável $OldHostGroup (OldHostGroup) para um local em seu novo grupo de host pai, armazenado na variável $NewHostGroup.

Exemplo 2: mover todos os grupos de host para um novo grupo de host pai

PS C:\> $AllGroups = Get-SCVMHostGroup
PS C:\> $HostGroup = New-SCVMHostGroup -Name "NewHostGroup01" 
PS C:\> $AllGroups | Move-SCVMHostGroup -ParentHostGroup $HostGroup

O primeiro comando obtém todos os objetos do grupo de host e os armazena na matriz $AllGroups. Isso inclui o grupo de host pai padrão (Todos os Hosts).

O segundo comando cria um objeto de grupo de host chamado NewHostGroup01 e o armazena na variável $HostGroup.

O último comando passa cada objeto de grupo de host armazenado na variável $AllGroups para o cmdlet Move-VMHostGroup , que move cada objeto de grupo de host para o local armazenado na variável $HostGroup, exceto para Todos os Hosts porque Todos os Hosts são o grupo de host pai padrão e não podem ser movidos.

Parâmetros

-JobGroup

Especifica um identificador para uma série de comandos que serão 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 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

-ParentHostGroup

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

Type:HostGroup
Aliases:ParentVMHostGroup
Position:Named
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

-VMHostGroup

Especifica um objeto de grupo de host de máquina virtual.

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

Saídas

HostGroup

Esse cmdlet retorna um objeto HostGroup .

Observações

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