New-AzNetworkInterface

Odwołanie

Moduł:: Az.Network

Tworzy interfejs sieciowy.

Składnia

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
   [-NetworkSecurityGroupId <String>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -SubnetId <String>
   [-PublicIpAddressId <String>]
   [-NetworkSecurityGroupId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetworkInterface
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   [-EdgeZone <String>]
   -Subnet <PSSubnet>
   [-PublicIpAddress <PSPublicIpAddress>]
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-PrivateIpAddress <String>]
   [-IpConfigurationName <String>]
   [-DnsServer <String[]>]
   [-InternalDnsNameLabel <String>]
   [-DisableTcpStateTracking <String>]
   [-EnableIPForwarding]
   [-EnableAcceleratedNetworking]
   [-AuxiliaryMode <String>]
   [-AuxiliarySku <String>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzNetworkInterface tworzy interfejs sieciowy platformy Azure.

Przykłady

Przykład 1. Tworzenie interfejsu sieciowego platformy Azure

New-AzNetworkInterface -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"

To polecenie tworzy interfejs sieciowy o nazwie NetworkInterface001 z dynamicznie przypisanym prywatnym adresem IP z podsieci Subnet1 w sieci wirtualnej o nazwie VirtualNetwork1. Polecenie przypisuje również dwa serwery DNS do interfejsu sieciowego. Zasób podrzędny IPConfiguration zostanie utworzony automatycznie przy użyciu nazwy IPConfiguration1.

Przykład 2. Tworzenie interfejsu sieciowego platformy Azure przy użyciu obiektu konfiguracji adresu IP

$Subnet = Get-AzVirtualNetwork -Name "VirtualNetwork1" -ResourceGroupName "ResourceGroup1" 
$IPconfig = New-AzNetworkInterfaceIpConfig -Name "IPConfig1" -PrivateIpAddressVersion IPv4 -PrivateIpAddress "10.0.1.10" -SubnetId $Subnet.Subnets[0].Id
New-AzNetworkInterface -Name "NetworkInterface1" -ResourceGroupName "ResourceGroup1" -Location "centralus" -IpConfiguration $IPconfig

W tym przykładzie zostanie utworzony nowy interfejs sieciowy przy użyciu obiektu konfiguracji adresu IP. Obiekt konfiguracji adresu IP określa statyczny prywatny adres IPv4. Pierwsze polecenie pobiera istniejącą określoną sieć wirtualną używaną do przypisania podsieci w drugim poleceniu. Drugie polecenie tworzy konfigurację adresu IP interfejsu sieciowego o nazwie IPConfig1 i przechowuje konfigurację w zmiennej o nazwie $IPconfig. Trzecie polecenie tworzy interfejs sieciowy o nazwie NetworkInterface1, który używa konfiguracji adresu IP interfejsu sieciowego przechowywanej w zmiennej o nazwie $IPconfig.

Przykład 3

Tworzy interfejs sieciowy. (automatycznie wygenerowane)

New-AzNetworkInterface -Location 'West US' -Name 'NetworkInterface1' -PrivateIpAddress '10.0.1.10' -ResourceGroupName 'ResourceGroup1' -SubnetId '/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/ResourceGroup1/providers/Microsoft.Network/virtualNetworks/VirtualNetwork1/subnets/Subnet1'

Parametry

-ApplicationGatewayBackendAddressPool

Określa obiekt ApplicationGatewayBackendAddressPool .

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

-ApplicationGatewayBackendAddressPoolId

Określa identyfikator obiektu ApplicationGatewayBackendAddressPool .

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

-ApplicationSecurityGroup

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której powinna należeć konfiguracja adresu IP interfejsu sieciowego.

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

-ApplicationSecurityGroupId

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której powinna należeć konfiguracja adresu IP interfejsu sieciowego.

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

-AsJob

Uruchamianie polecenia cmdlet w tle

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

-AuxiliaryMode

Tryb pomocniczy interfejsu sieciowego

Type:	String
Accepted values:	None, MaxConnections, AcceleratedConnections, Floating
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuxiliarySku

Pomocnicza jednostka SKU interfejsu sieciowego

Type:	String
Accepted values:	None, A1, A2, A4, A8
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

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

-DisableTcpStateTracking

Wskazuje, czy wyłączyć śledzenie stanu tcp.

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

-DnsServer

Określa serwer DNS dla interfejsu sieciowego.

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

-EdgeZone

Strefa brzegowa interfejsu sieciowego

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

-EnableAcceleratedNetworking

Włącza przyspieszoną sieć.

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

-EnableIPForwarding

Wskazuje, że to polecenie cmdlet umożliwia przekazywanie adresów IP dla interfejsu sieciowego. Przekazywanie adresów IP umożliwia maszynie wirtualnej odbieranie ruchu adresowanego do innych miejsc docelowych.

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

-Force

Wymusza utworzenie interfejsu sieciowego, nawet jeśli interfejs sieciowy o tej samej nazwie już istnieje.

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

-InternalDnsNameLabel

Określa wewnętrzną etykietę nazwy DNS dla nowego interfejsu sieciowego.

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

-IpConfiguration

Określa konfigurację adresu IP używaną przez to polecenie cmdlet dla interfejsu sieciowego.

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

-IpConfigurationName

Określa nazwę konfiguracji adresu IP.

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

-LoadBalancerBackendAddressPool

Określa obiekt BackendAddressPool .

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

-LoadBalancerBackendAddressPoolId

Określa identyfikator obiektu BackendAddressPool .

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

-LoadBalancerInboundNatRule

Określa konfigurację reguły NAT dla ruchu przychodzącego dla modułu równoważenia obciążenia.

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

-LoadBalancerInboundNatRuleId

Określa identyfikator konfiguracji reguły nat dla ruchu przychodzącego dla modułu równoważenia obciążenia.

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

-Location

Określa region interfejsu sieciowego.

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

-Name

Określa nazwę interfejsu sieciowego do utworzenia.

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

-NetworkSecurityGroup

Określa obiekt NetworkSecurityGroup .

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

-NetworkSecurityGroupId

Określa identyfikator sieciowej grupy zabezpieczeń.

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

-PrivateIpAddress

Określa statyczny adres IP IPv4 do przypisania do tego interfejsu sieciowego.

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

-PublicIpAddress

Określa obiekt PublicIPAddress do przypisania do interfejsu sieciowego.

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

-PublicIpAddressId

Określa identyfikator obiektu PublicIPAddress , który ma zostać przypisany do interfejsu sieciowego.

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

-ResourceGroupName

Określa nazwę grupy zasobów, do którego należy interfejs sieciowy.

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

-Subnet

Określa obiekt podsieci. To polecenie cmdlet tworzy interfejs sieciowy dla podsieci określonej przez ten parametr.

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

-SubnetId

Określa identyfikator podsieci, dla której ma zostać utworzony interfejs sieciowy.

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

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

String

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

Dane wyjściowe

PSNetworkInterface