New-AzNetworkInterface
Erstellt eine Netzwerkschnittstelle.
Syntax
SetByIpConfigurationResource (Standard)
New-AzNetworkInterface
-Name <String>
-ResourceGroupName <String>
-Location <String>
-IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
[-EdgeZone <String>]
[-DnsServer <String[]>]
[-InternalDnsNameLabel <String>]
[-DisableTcpStateTracking <String>]
[-EnableIPForwarding]
[-EnableAcceleratedNetworking]
[-AuxiliaryMode <String>]
[-AuxiliarySku <String>]
[-Tag <Hashtable>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SetByIpConfigurationResourceId
New-AzNetworkInterface
-Name <String>
-ResourceGroupName <String>
-Location <String>
-IpConfiguration <PSNetworkInterfaceIPConfiguration[]>
[-EdgeZone <String>]
[-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>]
SetByResourceId
New-AzNetworkInterface
-Name <String>
-ResourceGroupName <String>
-Location <String>
-SubnetId <String>
[-EdgeZone <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>]
SetByResource
New-AzNetworkInterface
-Name <String>
-ResourceGroupName <String>
-Location <String>
-Subnet <PSSubnet>
[-EdgeZone <String>]
[-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>]
Beschreibung
Das Cmdlet New-AzNetworkInterface erstellt eine Azure-Netzwerkschnittstelle .
Beispiele
Beispiel 1: Erstellen einer Azure-Netzwerkschnittstelle
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"
Dieser Befehl erstellt eine Netzwerkschnittstelle namens NetworkInterface001 mit einer dynamisch zugewiesenen privaten IP-Adresse aus Subnetz1 im virtuellen Netzwerk namens VirtualNetwork1. Der Befehl weist der Netzwerkschnittstelle auch zwei DNS-Server zu. Die untergeordnete IPConfiguration-Ressource wird automatisch mit dem Namen "IPConfiguration1" erstellt.
Beispiel 2: Erstellen einer Azure-Netzwerkschnittstelle mithilfe eines IP-Konfigurationsobjekts
$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 diesem Beispiel wird eine neue Netzwerkschnittstelle mithilfe eines IP-Konfigurationsobjekts erstellt. Das IP-Konfigurationsobjekt gibt eine statische private IPv4-Adresse an.
Der erste Befehl ruft ein vorhandenes angegebenes virtuelles Netzwerk ab, mit dem das Subnetz im zweiten Befehl zugewiesen wird.
Der zweite Befehl erstellt eine IP-Konfiguration der Netzwerkschnittstelle namens IPConfig1 und speichert die Konfiguration in der Variablen namens $IPconfig.
Der dritte Befehl erstellt eine Netzwerkschnittstelle namens NetworkInterface1, die die IP-Konfiguration der Netzwerkschnittstelle verwendet, die in der Variablen namens $IPconfig gespeichert ist.
Beispiel 3
Erstellt eine Netzwerkschnittstelle. (autogenerated)
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'
Parameter
-ApplicationGatewayBackendAddressPool
Gibt ein ApplicationGatewayBackendAddressPool -Objekt an.
Parametereigenschaften
Parametersätze
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ApplicationGatewayBackendAddressPoolId
Gibt die ID eines ApplicationGatewayBackendAddressPool - Objekts an.
Parametereigenschaften
Typ: String [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ApplicationSecurityGroup
Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen die IP-Konfiguration der Netzwerkschnittstelle gehören soll.
Parametereigenschaften
Parametersätze
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ApplicationSecurityGroupId
Gibt eine Auflistung von Anwendungssicherheitsgruppenverweisen an, zu denen die IP-Konfiguration der Netzwerkschnittstelle gehören soll.
Parametereigenschaften
Typ: String [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-AsJob
Cmdlet im Hintergrund ausführen
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-AuxiliaryMode
Der Hilfsmodus der Netzwerkschnittstelle
Parametereigenschaften
Typ: String
Standardwert: None
Zulässige Werte: None, MaxConnections, AcceleratedConnections, Floating
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-AuxiliarySku
Die Hilfs-Sku der Netzwerkschnittstelle
Parametereigenschaften
Typ: String
Standardwert: None
Zulässige Werte: None, A1, A2, A4, A8
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: vgl
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-DisableTcpStateTracking
Gibt an, ob die Tcp-Zustandsnachverfolgung deaktiviert werden soll.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-DnsServer
Gibt den DNS-Server für die Netzwerkschnittstelle an.
Parametereigenschaften
Typ: String [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-EdgeZone
Die Randzone der Netzwerkschnittstelle
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-EnableAcceleratedNetworking
Aktiviert beschleunigte Netzwerke.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-EnableIPForwarding
Gibt an, dass dieses Cmdlet die IP-Weiterleitung für die Netzwerkschnittstelle aktiviert.
Mit der IP-Weiterleitung kann ein virtueller Computer Datenverkehr empfangen, der an andere Ziele adressiert ist.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Force
Erzwingt die Erstellung der Netzwerkschnittstelle, auch wenn bereits eine Netzwerkschnittstelle mit demselben Namen vorhanden ist.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-InternalDnsNameLabel
Gibt die interne DNS-Namensbezeichnung für die neue Netzwerkschnittstelle an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-IpConfiguration
Gibt die IP-Konfiguration an, die dieses Cmdlet für die Netzwerkschnittstelle verwendet.
Parametereigenschaften
Parametersätze
SetByIpConfigurationResource
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
SetByIpConfigurationResourceId
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-IpConfigurationName
Gibt den Namen einer IP-Konfiguration an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-LoadBalancerBackendAddressPool
Gibt ein Back-EndAddressPool - Objekt an.
Parametereigenschaften
Parametersätze
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-LoadBalancerBackendAddressPoolId
Gibt die ID eines Back-EndAddressPool - Objekts an.
Parametereigenschaften
Typ: String [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-LoadBalancerInboundNatRule
Gibt eine eingehende NAT-Regelkonfiguration für einen Lastenausgleich an.
Parametereigenschaften
Typ: PSInboundNatRule [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-LoadBalancerInboundNatRuleId
Gibt die ID einer eingehenden NAT-Regelkonfiguration für einen Lastenausgleich an.
Parametereigenschaften
Typ: String [ ]
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Location
Gibt die Region für eine Netzwerkschnittstelle an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Name
Gibt den Namen der zu erstellenden Netzwerkschnittstelle an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Ressourcenname
Parametersätze
(All)
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-NetworkSecurityGroup
Gibt ein NetworkSecurityGroup -Objekt an.
Parametereigenschaften
Parametersätze
SetByIpConfigurationResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-NetworkSecurityGroupId
Gibt die ID einer Netzwerksicherheitsgruppe an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByIpConfigurationResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-PrivateIpAddress
Gibt eine statische IPv4-IP-Adresse an, die dieser Netzwerkschnittstelle zugewiesen werden soll.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-PublicIpAddress
Gibt ein PublicIPAddress - Objekt an, das einer Netzwerkschnittstelle zugewiesen werden soll.
Parametereigenschaften
Typ: PSPublicIpAddress
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResource
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-PublicIpAddressId
Gibt die ID eines PublicIPAddress -Objekts an, das einer Netzwerkschnittstelle zugewiesen werden soll.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Gibt den Namen einer Ressourcengruppe an, zu der die Netzwerkschnittstelle gehört.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Subnet
Gibt ein Subnetzobjekt an.
Dieses Cmdlet erstellt eine Netzwerkschnittstelle für das Subnetz, das dieser Parameter angibt.
Parametereigenschaften
Typ: PSSubnet
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResource
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-SubnetId
Gibt die ID des Subnetzes an, für das eine Netzwerkschnittstelle erstellt werden soll.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
SetByResourceId
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Tag
Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}
Parametereigenschaften
Typ: Hashtable
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird.
Das Cmdlet wird nicht ausgeführt.
Parametereigenschaften
Typ: SwitchParameter
Standardwert: False
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: Wi
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters .
Ausgaben