Compartilhar via


New-AzureRmVmssIpConfig

Cria uma configuração de IP para um adaptador de rede de um VMSS.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

New-AzureRmVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzureRmVmssIpConfig cria um objeto de configuração de IP para um adaptador de rede de um VMSS (Conjunto de Dimensionamento de Máquinas Virtuais). Especifique a configuração desse cmdlet como o parâmetro IPConfiguration do cmdlet Add-AzureRmVmssNetworkInterfaceConfiguration.

Exemplos

Exemplo 1: Criar um objeto de configuração de IP para uma interface VMSS

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

Esse comando cria um objeto de configuração de IP chamado ContosoVmssInterface02. O comando usa uma ID de sub-rede definida anteriormente armazenada em $SubnetId. O comando armazena as definições de configuração na variável $IPConfiguration para uso posterior com Add-AzureRmVmssNetworkInterfaceConfiguration.

Exemplo 2: Criar um objeto de configuração de IP que inclua configurações de pool NAT

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

Esse comando cria um objeto de configuração de IP chamado ContosoVmssInterface03 e o armazena na variável $IPConfiguration para uso posterior. O comando usa uma ID de sub-rede definida anteriormente armazenada em $SubnetId. O comando armazena as definições de configuração na variável $IPConfiguration para uso posterior. O comando especifica valores para os parâmetros LoadBalancerInboundNatPoolsId e LoadBalancerBackendAddressPoolsId .

Parâmetros

-ApplicationGatewayBackendAddressPoolsId

Especifica uma matriz de referências a pools de endereços de back-end de balanceadores de carga. Um conjunto de dimensionamento pode fazer referência a pools de endereços de back-end de um balanceador de carga público e interno. Vários conjuntos de dimensionamento não podem usar o mesmo balanceador de carga.

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

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DnsSetting

As configurações de dns a serem aplicadas nos endereços publicIP. O rótulo de nome de domínio das configurações de DNS a serem aplicadas nos endereços publicIP. A concatenação do rótulo de nome de domínio e do índice vm serão os rótulos de nome de domínio dos recursos de endereço IP público que serão criados.

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

-Id

Especifica uma ID.

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

-IpTag

Especifica uma matriz de objetos Ip Tag.

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

-LoadBalancerBackendAddressPoolsId

Especifica uma matriz de referências a pools de conversão de endereços de rede (NAT) de entrada dos balanceadores de carga. Um conjunto de dimensionamento pode fazer referência a pools NAT de entrada de um balanceador de carga público e interno. Vários conjuntos de dimensionamento não podem usar o mesmo balanceador de carga.

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

-LoadBalancerInboundNatPoolsId

Especifica uma matriz de referências a pools NAT de entrada dos balanceadores de carga. Um conjunto de dimensionamento pode fazer referência a pools NAT de entrada de um balanceador de carga público e interno. Vários conjuntos de dimensionamento não podem usar o mesmo balanceador de carga.

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

-Name

Especifica o nome da configuração de IP.

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

-Primary

Especifica a configuração de IP principal caso a interface de rede tenha mais de uma configuração de IP.

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

-PrivateIPAddressVersion

Especifique que a configuração de ip é IPv4 ou IPv6. O padrão é considerado IPv4. Os valores possíveis são: 'IPv4' e 'IPv6'.

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

O tempo limite ocioso do endereço IP público.

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

-PublicIPAddressConfigurationName

O nome de configuração do endereço publicIP.

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

-PublicIPPrefix

O ID do prefixo IP público

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

-SubnetId

Especifica a ID da sub-rede na qual a configuração cria o adaptador de rede VMSS.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

Saídas

VirtualMachineScaleSetIPConfiguration