New-VMGroup
Resumo
Cria um grupo de máquinas virtuais.
Parâmetros
Parâmetro | Tipo | Escolhas | Valor Padrão | Comentários |
|---|---|---|---|
-CimSession | string | | Executa o cmdlet em uma sessão remota ou em um computador remoto. Insira um nome de computador ou um objeto de sessão, como a saída de um cmdlet New-CimSession ou Get-CimSession. O padrão é a sessão atual no computador local. |
-ComputerName | string | | Especifica um ou mais hosts Hyper-V que executam este cmdlet. Nomes NetBIOS, endereços IP e nomes de domínio totalmente qualificados são permitidos. O padrão é o computador local. Use localhost ou um ponto (.) para especificar o computador local explicitamente. |
-Credential | string | | As contas de usuário que terão permissão para executar esta ação. O padrão é o usuário atual. |
-GroupType | string | | Tipo de grupo que este cmdlet irá criar. Os valores aceitáveis para este parâmetro são: ManagementCollectionType e VMCollectionType. |
-Id | id | | ID exclusivo do grupo que o cmdlet irá criar. |
-Name | string | | Nome do grupo que o cmdlet irá criar. |
Exemplos
# Exemplo: Crie um grupo para conter máquinas virtuais
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
New-VMGroup -Name 'CollectionGroup07' -GroupType VMCollectionType
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
# Exemplo: Crie um grupo para conter grupos de máquinas virtuais
tasks:
powershell_command:
server: {{ server }}
username: {{ username }}
password: {{ password }}
command: |
New-VMGroup -Name 'ManagementCollectionGroup03' -GroupType ManagementCollectionType
register: result
- debug:
msg: |
{{ result.output }}
{{ result.had_errors }}
{{ result.output_errors }}
{{ result.output_warnings }}
Valores retornados
Chave | Tipo | Retornado quando | Descrição |
|---|---|---|---|
output | string | Sempre | Saída da execução. |
had_errors | boolean | Sempre | Se teve erros. |
output_errors | string | Sempre | Erros de saída da execução. |
output_warnings | string | Sempre | Avisos de saída. |