New-AzureRmNetworkInterfaceIpConfig

  • Reference
Modul:
AzureRM.Network

Vytvoří konfiguraci PROTOKOLU IP síťového rozhraní.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

New-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Rutina New-AzureRmNetworkInterfaceIpConfig vytvoří konfiguraci PROTOKOLU IP síťového rozhraní Azure pro síťové rozhraní.

Příklady

1: Vytvoření konfigurace PROTOKOLU IP s veřejnou IP adresou pro síťové rozhraní

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzureRmPublicIPAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1
    -Primary

 $nic = New-AzureRmNetworkInterface -Name $NicName -ResourceGroupName myrg -Location westus
    -IpConfiguration $IpConfig1

První dva příkazy získají virtuální síť s názvem myvnet a podsíť s názvem mysubnet, která byla dříve vytvořena. Jsou uloženy v $vnet a $Subnet. Třetí příkaz získá dříve vytvořenou veřejnou IP adresu s názvem PIP1. Příkaz forth vytvoří novou konfiguraci PROTOKOLU IP s názvem IPConfig-1 jako primární konfiguraci IP adresy s přidruženou veřejnou IP adresou. Poslední příkaz pak pomocí této konfigurace PROTOKOLU IP vytvoří síťové rozhraní mynic1.

2: Vytvoření konfigurace PROTOKOLU IP s privátní IP adresou

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$IPConfig2 = New-AzureRmNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress
    10.0.0.5

$nic = New-AzureRmNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration
    $IpConfig2

První dva příkazy získají virtuální síť s názvem myvnet a podsíť s názvem mysubnet, která byla dříve vytvořena. Jsou uloženy v $vnet a $Subnet. Třetí příkaz vytvoří novou konfiguraci PROTOKOLU IP s názvem IPConfig-2 s přidruženou privátní IP adresou 10.0.0.5. Poslední příkaz pak pomocí této konfigurace PROTOKOLU IP vytvoří síťové rozhraní mynic1.

Parametry

-ApplicationGatewayBackendAddressPool

Určuje kolekci back-endového fondu adres služby Application Gateway, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationGatewayBackendAddressPoolId

Určuje kolekci back-endového fondu adres služby Application Gateway, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationSecurityGroup

Určuje kolekci odkazů na skupinu zabezpečení aplikace, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[PSApplicationSecurityGroup]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationSecurityGroupId

Určuje kolekci odkazů na skupinu zabezpečení aplikace, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LoadBalancerBackendAddressPool

Určuje kolekci odkazů back-endového fondu adres nástroje pro vyrovnávání zatížení, do kterého patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[PSBackendAddressPool]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-LoadBalancerBackendAddressPoolId

Určuje kolekci odkazů back-endového fondu adres nástroje pro vyrovnávání zatížení, do kterého patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-LoadBalancerInboundNatRule

Určuje kolekci příchozích pravidel nat nástroje pro vyrovnávání zatížení, na které toto síťové rozhraní IPConfiguration patří.

Typ:List<T>[PSInboundNatRule]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-LoadBalancerInboundNatRuleId

Určuje kolekci příchozích pravidel překladu síťových adres (NAT) nástroje pro vyrovnávání zatížení, na které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název konfigurace PROTOKOLU IP síťového rozhraní.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Primary

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrivateIpAddress

Určuje statickou IP adresu konfigurace protokolu IP síťového rozhraní.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrivateIpAddressVersion

Určuje verzi IP adresy konfigurace PROTOKOLU IP síťového rozhraní. Tento parametr přijímá tyto hodnoty:

  • IPv4
  • IPv6
Typ:String
Přípustné hodnoty:IPv4, IPv6
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicIpAddress

Určuje objekt PublicIPAddress . Tato rutina vytvoří odkaz na veřejnou IP adresu, která se přidruží k této konfiguraci PROTOKOLU IP síťového rozhraní.

Typ:PSPublicIpAddress
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PublicIpAddressId

Tato rutina vytvoří odkaz na veřejnou IP adresu, která se přidruží k této konfiguraci PROTOKOLU IP síťového rozhraní.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Subnet

Určuje objekt podsítě . Tato rutina vytvoří odkaz na podsíť, ve které se vytvoří konfigurace PROTOKOLU IP tohoto síťového rozhraní.

Typ:PSSubnet
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubnetId

Určuje odkaz na podsíť, ve které se vytvoří tato konfigurace PROTOKOLU IP síťového rozhraní.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Výstupy

PSNetworkInterfaceIPConfiguration

Poznámky

  • Klíčová slova: azure, azurerm, arm, resource, management, manager, network, networking