New-AzNetworkInterfaceIpConfig

Modul:

Az.Network Module

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

Syntax

SetByResource (Výchozí)

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

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

Příklady

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

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

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

$nic = New-AzNetworkInterface -Name mynic1 -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.

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

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

$nic = New-AzNetworkInterface -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.

Příklad 3

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

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

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í.

Vlastnosti parametru

Typ:	PSApplicationGatewayBackendAddressPool[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ApplicationSecurityGroup

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

Vlastnosti parametru

Typ:	PSApplicationSecurityGroup[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ApplicationSecurityGroupId

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-GatewayLoadBalancerId

Odkaz na prostředek zprostředkovatele vyrovnávání zatížení brány.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSBackendAddressPool[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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ří.

Vlastnosti parametru

Typ:	PSInboundNatRule[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Primary

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateIpAddress

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateIPAddressPrefixLength

Určuje délku předpony statické IP adresy konfigurace PROTOKOLU IP síťového rozhraní.

Vlastnosti parametru

Typ:	Nullable<T>[Int32]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateIpAddressVersion

Určuje verzi IP adresy konfigurace PROTOKOLU IP síťového rozhraní. Přijatelné hodnoty pro tento parametr jsou:

• protokol IPv4
• protokol IPv6

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	IPv4, IPv6
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSPublicIpAddress
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSSubnet
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SubnetId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Výstupy

PSNetworkInterfaceIPConfiguration

Poznámky

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

Související odkazy

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig
• Set-AzNetworkInterfaceIpConfig