New-AzureRmNetworkInterface

Reference

Modul:: AzureRM.Network

Vytvoří síťové 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.

Syntax

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -IpConfiguration <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSNetworkInterfaceIPConfiguration]>
   [-NetworkSecurityGroupId <String>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -SubnetId <String>
   [-PublicIpAddressId <String>]
   [-NetworkSecurityGroupId <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]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Subnet <PSSubnet>
   [-PublicIpAddress <PSPublicIpAddress>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-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]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <System.Collections.Generic.List`1[System.String]>]
   [-InternalDnsNameLabel <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Rutina New-AzureRmNetworkInterface vytvoří síťové rozhraní Azure.

Příklady

Příklad 1: Vytvoření síťového rozhraní Azure

PS C:\>New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1" -IpConfigurationName "IPConfiguration1" -DnsServer "8.8.8.8", "8.8.4.4"

Tento příkaz vytvoří síťové rozhraní s názvem NetworkInterface001 s dynamicky přiřazenou privátní IP adresou z podsítě1 ve virtuální síti s názvem VirtualNetwork1. Příkaz také přiřadí k síťovému rozhraní dva servery DNS. Podřízený prostředek IPConfiguration se vytvoří automaticky pomocí názvu IPConfiguration1.

Příklad 2: Vytvoření síťového rozhraní Azure pomocí objektu konfigurace PROTOKOLU IP

PS C:\>$IPconfig = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1"
PS C:\> New-AzureRmNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

Tento příklad vytvoří nové síťové rozhraní pomocí objektu konfigurace PROTOKOLU IP. Objekt konfigurace PROTOKOLU IP určuje statickou privátní adresu IPv4. První příkaz vytvoří konfiguraci PROTOKOLU IP síťového rozhraní s názvem IPConfig1 a uloží konfiguraci do proměnné s názvem $IPconfig. Druhý příkaz vytvoří síťové rozhraní s názvem NetworkInterface1, které používá konfiguraci PROTOKOLU IP síťového rozhraní uloženou v proměnné s názvem $IPconfig.

Parametry

-ApplicationGatewayBackendAddressPool

Určuje ApplicationGatewayBackendAddressPool objekt.

Type:	List<T>[PSApplicationGatewayBackendAddressPool]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationGatewayBackendAddressPoolId

Určuje ID objektu ApplicationGatewayBackendAddressPool .

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroup

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

Type:	List<T>[PSApplicationSecurityGroup]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroupId

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

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AsJob

Spuštění rutiny na pozadí

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DnsServer

Určuje server DNS pro síťové rozhraní.

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-EnableAcceleratedNetworking

Umožňuje akcelerované síťové služby.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableIPForwarding

Označuje, že tato rutina povoluje předávání IP pro síťové rozhraní. Předávání IP umožňuje virtuálnímu počítači přijímat provoz adresovaný do jiných cílů.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Vynutí vytvoření síťového rozhraní i v případě, že již existuje síťové rozhraní se stejným názvem.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InternalDnsNameLabel

Určuje interní popisek názvu DNS pro nové síťové rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-IpConfiguration

Určuje konfiguraci PROTOKOLU IP, kterou tato rutina používá pro síťové rozhraní.

Type:	List<T>[PSNetworkInterfaceIPConfiguration]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IpConfigurationName

Určuje název konfigurace PROTOKOLU IP.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPool

Určuje backendAddressPool objekt.

Type:	List<T>[PSBackendAddressPool]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPoolId

Určuje ID objektu BackendAddressPool .

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRule

Určuje konfiguraci příchozího pravidla PŘEKLADU adres (NAT) pro nástroj pro vyrovnávání zatížení.

Type:	List<T>[PSInboundNatRule]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRuleId

Určuje ID konfigurace příchozího pravidla NAT pro nástroj pro vyrovnávání zatížení.

Type:	List<T>[String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Location

Určuje oblast pro síťové rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Určuje název síťového rozhraní, které se má vytvořit.

Type:	String
Aliases:	ResourceName
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkSecurityGroup

Určuje objekt NetworkSecurityGroup .

Type:	PSNetworkSecurityGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkSecurityGroupId

Určuje ID skupiny zabezpečení sítě.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PrivateIpAddress

Určuje statickou IP adresu IPv4, která se má přiřadit k tomuto síťovému rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpAddress

Určuje objekt PublicIPAddress , který se má přiřadit k síťovému rozhraní.

Type:	PSPublicIpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-PublicIpAddressId

Určuje ID objektu PublicIPAddress pro přiřazení k síťovému rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ResourceGroupName

Určuje název skupiny prostředků, do které síťové rozhraní patří.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Subnet

Určuje objekt podsítě . Tato rutina vytvoří síťové rozhraní pro podsíť, kterou tento parametr určuje.

Type:	PSSubnet
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubnetId

Určuje ID podsítě, pro kterou se má vytvořit síťové rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

String

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

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

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]]

Hashtable

Výstupy

PSNetworkInterface

Share via