Partilhar via

New-AzureRmVmssIpConfig

  • Referência
Módulo:
AzureRM.Compute

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

Aviso

O módulo AzureRM do PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação 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 IP para uma interface de rede de um VMSS (Virtual Machine Scale set). Especifique a configuração deste cmdlet como o parâmetro IPConfiguration do cmdlet Add-AzureRmVmssNetworkInterfaceConfiguration.

Exemplos

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

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

Este comando cria um objeto de configuração IP chamado ContosoVmssInterface02. O comando usa um ID de sub-rede previamente definido armazenado no $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 IP que inclua configurações de pool de NAT

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

Este comando cria um objeto de configuração IP chamado ContosoVmssInterface03 e, em seguida, armazena-o na variável $IPConfiguration para uso posterior. O comando usa um ID de sub-rede previamente definido armazenado no $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 escala não podem usar o mesmo balanceador de carga.

Tipo:String[]
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DnsSetting

As configurações de dns a serem aplicadas nos endereços IP públicos. O rótulo de nome de domínio das configurações de Dns a serem aplicadas nos endereços IP públicos. 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Id

Especifica uma ID.

Tipo:String
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-IpTag

Especifica uma matriz de objetos Ip Tag.

Tipo:VirtualMachineScaleSetIpTag[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancerBackendAddressPoolsId

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

Tipo:String[]
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancerInboundNatPoolsId

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

Tipo:String[]
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da configuração IP.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Primary

Especifica a Configuração de IP primária caso a interface de rede tenha mais de uma Configuração de IP.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrivateIPAddressVersion

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PublicIPAddressConfigurationIdleTimeoutInMinutes

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

Tipo:Int32
Aliases:PublicIPAddressIdleTimeoutInMinutes
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PublicIPAddressConfigurationName

O nome de configuração do endereço IP público.

Tipo:String
Aliases:PublicIPAddressName
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PublicIPPrefix

A ID do prefixo IP público

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SubnetId

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

Tipo:String
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

Saídas

VirtualMachineScaleSetIPConfiguration