Compartilhar via

New-SCVMSubnet

  • Referência
Módulo:
VirtualMachineManager

Cria uma sub-rede de máquina virtual.

Sintaxe

New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -SubnetVLan <SubnetVLan[]>
   -VMNetwork <VMNetwork>
   [-VMSubnetID <UInt32>]
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   -SubnetVLan <SubnetVLan[]>
   -VMNetwork <VMNetwork>
   -LogicalNetworkDefinition <LogicalNetworkDefinition>
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMSubnet
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [[-Description] <String>]
   [-VMSubnetExternal]
   -VMNetwork <VMNetwork>
   [-MaxNumberOfPorts <UInt32>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet New-SCVMSubnet cria uma sub-rede de máquina virtual. Uma sub-rede de máquina virtual é uma sub-rede IP associada a uma rede de máquina virtual.

Ao criar uma sub-rede de máquina virtual, você deve fornecer objetos SubNetVLan e VMNetwork. Para criar o objeto SubnetVLan , use o cmdlet New-SCSubnetVLan . Para obter um objeto VMNetwork, use o cmdlet Get-SCVMNetwork . A rede lógica usada pela rede da máquina virtual deve ser habilitada para virtualização de rede.

Exemplos

Exemplo 1: criar uma sub-rede de máquina virtual que usa NVGRE como o mecanismo de encapsulamento

PS C:\> $SubNetVLan = New-SCSubnetVLan -Subnet "192.168.3.0/24"
PS C:\> $VMNetwork = Get-SCVMNetwork -Name "VMNetwork01"
PS C:\> New-SCVMSubnet -Name "VMSubnet01" -SubnetVLan $SubnetVLan -VMNetwork $VMNetwork

O primeiro comando cria um objeto VLan de sub-rede e armazena o objeto na variável $SubNetVLan.

O segundo comando obtém o objeto de rede de máquina virtual chamado VMNetwork 01 e armazena o objeto na variável $VMNetwork.

O último comando cria uma sub-rede de máquina virtual com o nome VMSubnet01 usando a VLan de sub-rede armazenada em $SubnetVLan e a rede de máquina virtual armazenada em $VMNetwork.

Parâmetros

-Description

Especifica uma descrição para uma sub-rede de máquina virtual.

Tipo:String
Cargo:1
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

-LogicalNetworkDefinition

Especifica uma definição de rede lógica (também conhecida como site de rede) que contém a sub-rede que o pool de endereços IP serve conforme especificado pelo parâmetro SubnetVLan.

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

-MaxNumberOfPorts

Especifica o número máximo de portas compatíveis com a sub-rede da máquina virtual.

Tipo:UInt32
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 VMM (Virtual Machine Manager).

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado 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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-PortACL

Especifica uma ACL (lista de controle de acesso à porta).

Tipo:PortACL
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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

-SubnetVLan

Especifica uma ou mais sub-redes IP e conjuntos de VLAN.

Para obter informações sobre como criar uma SubnetVLan, digite Get-Help New-SCSubNetVLan.

Tipo:SubnetVLan[]
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-VMNetwork

Especifica um objeto de rede de máquina virtual.

Para obter um objeto de rede de máquina virtual, use o cmdlet Get-SCVMNetwork.

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

-VMSubnetExternal

Indica que a rede da máquina virtual é capaz de se comunicar com outras redes.

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

-VMSubnetID

Especifica a ID de uma sub-rede de máquina virtual.

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