Compartilhar via

New-SCVMHostGroup

  • Referência
Módulo:
VirtualMachineManager

Cria um grupo de hosts que pode conter computadores host de máquina virtual, outros grupos de hosts ou clusters de host.

Sintaxe

New-SCVMHostGroup
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-ParentHostGroup <HostGroup>]
   [-EnableUnencryptedFileTransfer <Boolean>]
   [-InheritNetworkSettings <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet New-SCVMHostGroup cria um objeto de grupo de hosts que pode conter computadores host nos quais uma ou mais máquinas virtuais são implantadas, outros grupos de hosts ou clusters de host.

O VMM (Virtual Machine Manager) fornece um grupo de hosts pai padrão chamado Todos os Hosts, ao qual você pode adicionar grupos de host filho. Um novo grupo de hosts fica vazio até que você mova hosts para ele ou crie um ou mais grupos de hosts filho sob ele. Os grupos de hosts são organizados em uma estrutura de árvore hierárquica e personalizável. Na árvore do grupo de hosts, o pai de um novo grupo de hosts é o grupo de hosts raiz padrão (Todos os Hosts) ou um grupo de hosts criado pelo usuário.

Um grupo de hosts pode ser um contêiner pai para qualquer um dos seguintes:

  • Um host ou um conjunto de hosts
  • Um grupo de hosts ou um conjunto de grupos de hosts e hosts dentro desses grupos de hosts
  • Um cluster de host e hosts (nós) dentro desse cluster de host

Os hosts contidos em um grupo de hosts têm uma propriedade de caminho de host que mostra a localização desse host na hierarquia do grupo de hosts, conforme ilustrado na tabela a seguir:

Caminho do nome

  • Todos os hosts todos os hosts
  • ChildHostGroup01 All Hosts\ChildHostGroup01
  • ChildHostGroup02 All Hosts\ChildHostGroup02
  • Novo Datacenter Todos os Hosts\Novo Datacenter
  • aninhado1 Todos os Hosts\Novo Datacenter\nested01
  • aninhado2 Todos os Hosts\Novo Datacenter\nested\nested02

Exemplos

Exemplo 1: Criar um grupo de host no grupo de hosts raiz

PS C:\> New-SCVMHostGroup -VMMServer "VMMServer01.Contoso.com" -Name "HostGroup01"

Esse comando cria um grupo de hosts chamado HostGroup01 no VMMServer01 no domínio Contoso.com. Por padrão, o VMM coloca esse grupo de hosts no grupo de hosts raiz, que é chamado de Todos os Hosts.

Exemplo 2: Criar um grupo de hosts em um grupo de host pai especificado

PS C:\> $ParentGroup = Get-SCVMHostGroup -Name "HostGroup01" 
PS C:\> New-SCVMHostGroup -Name "ChildGroup01" -ParentHostGroup $ParentGroup

O primeiro comando obtém o grupo de hosts chamado HostGroup01 e o armazena na variável $ParentGroup.

O segundo comando cria um grupo de hosts chamado ChildGroup01 e o coloca sob o grupo de hosts pai armazenado na variável $ParentGroup.

Parâmetros

-Description

Especifica uma descrição para o grupo de hosts.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableUnencryptedFileTransfer

Indica, quando definido como True, que as transferências de arquivo de rede não exigem criptografia. Permitir transferências de arquivos de rede não criptografadas pode melhorar o desempenho se o host de origem nem o host de destino exigirem criptografia.

Use este parâmetro para:

  • Habilite transferências de arquivo não criptografadas para dentro ou fora da biblioteca.
  • Habilite transferências de arquivo não criptografadas para, fora ou dentro de um grupo de hosts.
Tipo:Boolean
Aliases:AllowUnencryptedTransfers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InheritNetworkSettings

Indica, quando definido como $True, que as configurações de rede de um grupo de hosts terão os mesmos valores especificados para seu pai.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-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

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
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:False
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

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

HostGroup

Esse cmdlet retorna um objeto HostGroup.