New-VMSwitch

4 min

Resumo

Cria um novo switch virtual em um ou mais hosts de máquinas virtuais.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
-AllowManagementOS	boolean	Escolhas: - false - true	Especifica se a partição pai (ou seja, o sistema operacional de gerenciamento) deve ter acesso à NIC física vinculada ao switch virtual a ser criado.
-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 nos quais o switch virtual deve ser criado. 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.
-Confirm	string		Solicita confirmação antes de executar o cmdlet.
-Credential	string		Especifica uma ou mais contas de usuário que têm permissão para executar esta ação. O padrão é o usuário atual.
-EnableEmbeddedTeaming	boolean	Escolhas: - false - true	Especifica se este cmdlet habilita o agrupamento para o switch virtual.
-EnableIov	boolean	Escolhas: - false - true	Especifica que a virtualização de E/S deve ser habilitada no switch virtual a ser criado.
-EnablePacketDirect	boolean	Escolhas: - false - true	Especifica se este cmdlet habilita o caminho direto do pacote por meio do switch virtual. O valor padrão é $False.
-MinimumBandwidthMode	string	Escolhas: - Default - Weight - Absolute - None	Especifica como a largura de banda mínima deve ser configurada no switch virtual. Os valores permitidos são Absolute, Default, None, or Weight. Se for especificado Absolute, a largura de banda mínima é de bits por segundo. Se Weight for especificado, a largura de banda mínima será um valor que varia de 1 a 100. Se None for especificado, a largura de banda mínima será desativada no switch, ou seja, os usuários não poderão configurá-la em nenhum adaptador de rede conectado ao switch. Se Default for especificado, o sistema definirá o modo como Weight, se a chave não estiver habilitada para IOV, ou None se a chave estiver habilitada para IOV.
-Name	string		Especifica o nome do switch a ser criado.
-NetAdapterInterfaceDescription	string		Especifica a descrição da interface do adaptador de rede a ser vinculado ao switch a ser criado. Você pode usar o cmdlet Get-NetAdapter para obter a descrição da interface de um adaptador de rede.
-NetAdapterName	string		Especifica o nome do adaptador de rede a ser vinculado ao switch a ser criado. Você pode usar o cmdlet Get-NetAdapter para obter a descrição da interface de um adaptador de rede.
-Notes	string		Especifica uma nota a ser associada ao switch a ser criado.
-SwitchType	string	Escolhas: - Internal - Private	Especifica o tipo de switch a ser criado. Os valores permitidos são Internal e Private. Para criar um switch virtual External, especifique o parâmetro NetAdapterInterfaceDescription ou NetAdapterName , que define implicitamente o tipo do switch virtual como Externo.
-WhatIf	boolean	Escolhas: - false - true	Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Exemplos

# Cria um novo switch QoS switch, que se liga a um adaptador de rede chamado
# "Wired Ethernet Connection 3" e suporta largura de banda mínima baseada em Weight.
tasks:
  powershell_command:
    server: {{ server }}
    username: {{ username }}
    password: {{ password }}
    command: |
      New-VMSwitch "QoS Switch" -NetAdapterName "Wired Ethernet Connection 3" -MinimumBandwidthMode Weight
  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.