New-AzNetworkInterface

Referentie

Module:: Az.Network

Hiermee maakt u een netwerkinterface.

Syntaxis

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

Description

Met de cmdlet New-AzNetworkInterface wordt een Azure-netwerkinterface gemaakt.

Voorbeelden

Voorbeeld 1: Een Azure-netwerkinterface maken

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"

Met deze opdracht maakt u een netwerkinterface met de naam NetworkInterface001 met een dynamisch toegewezen privé-IP-adres van Subnet1 in het virtuele netwerk met de naam VirtualNetwork1. Met de opdracht worden ook twee DNS-servers toegewezen aan de netwerkinterface. De onderliggende IPConfiguration-resource wordt automatisch gemaakt met de naam IPConfiguration1.

Voorbeeld 2: Een Azure-netwerkinterface maken met behulp van een IP-configuratieobject

$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

In dit voorbeeld wordt een nieuwe netwerkinterface gemaakt met behulp van een IP-configuratieobject. Het IP-configuratieobject geeft een statisch privé-IPv4-adres op. Met de eerste opdracht wordt een bestaand opgegeven virtueel netwerk opgehaald dat wordt gebruikt om het subnet toe te wijzen in de tweede opdracht. Met de tweede opdracht maakt u een IP-configuratie van de netwerkinterface met de naam IPConfig1 en slaat u de configuratie op in de variabele met de naam $IPconfig. Met de derde opdracht maakt u een netwerkinterface met de naam NetworkInterface1 die gebruikmaakt van de IP-configuratie van de netwerkinterface die is opgeslagen in de variabele met de naam $IPconfig.

Voorbeeld 3

Hiermee maakt u een netwerkinterface. (automatisch gegenereerd)

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'

Parameters

-ApplicationGatewayBackendAddressPool

Hiermee geeft u een ApplicationGatewayBackendAddressPool-object .

Type:	PSApplicationGatewayBackendAddressPool[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ApplicationGatewayBackendAddressPoolId

Hiermee geeft u de id van een ApplicationGatewayBackendAddressPool-object .

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ApplicationSecurityGroup

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe de IP-configuratie van de netwerkinterface moet behoren.

Type:	PSApplicationSecurityGroup[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ApplicationSecurityGroupId

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe de IP-configuratie van de netwerkinterface moet behoren.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AuxiliaryMode

De hulpmodus van de netwerkinterface

Type:	String
Geaccepteerde waarden:	None, MaxConnections, AcceleratedConnections, Floating
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-AuxiliarySku

De hulp-SKU van de netwerkinterface

Type:	String
Geaccepteerde waarden:	None, A1, A2, A4, A8
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DisableTcpStateTracking

Hiermee wordt aangegeven of tcp-statustracering moet worden uitgeschakeld.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-DnsServer

Hiermee geeft u de DNS-server voor de netwerkinterface.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EdgeZone

De randzone van de netwerkinterface

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-EnableAcceleratedNetworking

Maakt versneld netwerken mogelijk.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-EnableIPForwarding

Geeft aan dat met deze cmdlet doorsturen via IP voor de netwerkinterface is ingeschakeld. Met doorsturen via IP kan een virtuele machine verkeer ontvangen dat is geadresseerd aan andere bestemmingen.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Force

Dwingt het maken van de netwerkinterface af, zelfs als er al een netwerkinterface met dezelfde naam bestaat.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InternalDnsNameLabel

Hiermee geeft u het interne DNS-naamlabel voor de nieuwe netwerkinterface.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-IpConfiguration

Hiermee geeft u de IP-configuratie op die door deze cmdlet wordt gebruikt voor de netwerkinterface.

Type:	PSNetworkInterfaceIPConfiguration[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-IpConfigurationName

Hiermee geeft u de naam van een IP-configuratie.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LoadBalancerBackendAddressPool

Hiermee geeft u een BackendAddressPool-object .

Type:	PSBackendAddressPool[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LoadBalancerBackendAddressPoolId

Hiermee geeft u de id van een BackendAddressPool-object .

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LoadBalancerInboundNatRule

Hiermee geeft u een binnenkomende NAT-regelconfiguratie voor een load balancer.

Type:	PSInboundNatRule[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LoadBalancerInboundNatRuleId

Hiermee geeft u de id van een binnenkomende NAT-regelconfiguratie voor een load balancer.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Location

Hiermee geeft u de regio voor een netwerkinterface.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

Hiermee geeft u de naam van de netwerkinterface die moet worden gemaakt.

Type:	String
Aliassen:	ResourceName
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-NetworkSecurityGroup

Hiermee geeft u een NetworkSecurityGroup-object .

Type:	PSNetworkSecurityGroup
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-NetworkSecurityGroupId

Hiermee geeft u de id van een netwerkbeveiligingsgroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PrivateIpAddress

Hiermee geeft u een statisch IPv4 IP-adres toe te wijzen aan deze netwerkinterface.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PublicIpAddress

Hiermee geeft u een PublicIPAddress-object toe te wijzen aan een netwerkinterface.

Type:	PSPublicIpAddress
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PublicIpAddressId

Hiermee geeft u de id van een PublicIPAddress-object toe te wijzen aan een netwerkinterface.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceGroupName

Hiermee geeft u de naam van een resourcegroep waartoe de netwerkinterface behoort.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Subnet

Hiermee geeft u een Subnet-object . Met deze cmdlet maakt u een netwerkinterface voor het subnet dat met deze parameter wordt opgegeven.

Type:	PSSubnet
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-SubnetId

Hiermee geeft u de id op van het subnet waarvoor een netwerkinterface moet worden gemaakt.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Tag

Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}

Type:	Hashtable
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	False
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

String

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

Uitvoerwaarden

PSNetworkInterface

Delen via