New-AzNetworkInterface
Tworzy interfejs sieciowy.
Składnia
SetByIpConfigurationResource (Domyślna)
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>]
Opis
Polecenie cmdlet New-AzNetworkInterface tworzy interfejs sieciowy platformy Azure.
Przykłady
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.
$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. (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'
Parametry
-ApplicationGatewayBackendAddressPool
Określa obiekt ApplicationGatewayBackendAddressPool .
Właściwości parametru
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-ApplicationGatewayBackendAddressPoolId
Określa identyfikator obiektu ApplicationGatewayBackendAddressPool .
Właściwości parametru
Typ: String [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-ApplicationSecurityGroup
Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której powinna należeć konfiguracja adresu IP interfejsu sieciowego.
Właściwości parametru
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-ApplicationSecurityGroupId
Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której powinna należeć konfiguracja adresu IP interfejsu sieciowego.
Właściwości parametru
Typ: String [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-AsJob
Uruchamianie polecenia cmdlet w tle
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-AuxiliaryMode
Tryb pomocniczy interfejsu sieciowego
Właściwości parametru
Typ: String
Domyślna wartość: None
Dopuszczalne wartości: None, MaxConnections, AcceleratedConnections, Floating
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-AuxiliarySku
Pomocnicza jednostka SKU interfejsu sieciowego
Właściwości parametru
Typ: String
Domyślna wartość: None
Dopuszczalne wartości: None, A1, A2, A4, A8
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: False
Obsługuje symbole wieloznaczne: False
DontShow: False
Aliasy: por
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Właściwości parametru
Typ: IAzureContextContainer
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Aliasy: AzContext, AzureRmContext, AzureCredential
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-DisableTcpStateTracking
Wskazuje, czy wyłączyć śledzenie stanu tcp.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-DnsServer
Określa serwer DNS dla interfejsu sieciowego.
Właściwości parametru
Typ: String [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-EdgeZone
Strefa brzegowa interfejsu sieciowego
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-EnableAcceleratedNetworking
Włącza przyspieszoną sieć.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: 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.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-Force
Wymusza utworzenie interfejsu sieciowego, nawet jeśli interfejs sieciowy o tej samej nazwie już istnieje.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
-InternalDnsNameLabel
Określa wewnętrzną etykietę nazwy DNS dla nowego interfejsu sieciowego.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-IpConfiguration
Określa konfigurację adresu IP używaną przez to polecenie cmdlet dla interfejsu sieciowego.
Właściwości parametru
Zestawy parametrów
SetByIpConfigurationResource
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
SetByIpConfigurationResourceId
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-IpConfigurationName
Określa nazwę konfiguracji adresu IP.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-LoadBalancerBackendAddressPool
Określa obiekt BackendAddressPool .
Właściwości parametru
Typ: PSBackendAddressPool [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-LoadBalancerBackendAddressPoolId
Określa identyfikator obiektu BackendAddressPool .
Właściwości parametru
Typ: String [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-LoadBalancerInboundNatRule
Określa konfigurację reguły NAT dla ruchu przychodzącego dla modułu równoważenia obciążenia.
Właściwości parametru
Typ: PSInboundNatRule [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-LoadBalancerInboundNatRuleId
Określa identyfikator konfiguracji reguły nat dla ruchu przychodzącego dla modułu równoważenia obciążenia.
Właściwości parametru
Typ: String [ ]
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-Location
Określa region interfejsu sieciowego.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-Name
Określa nazwę interfejsu sieciowego do utworzenia.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Aliasy: NazwaZasobu
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-NetworkSecurityGroup
Określa obiekt NetworkSecurityGroup .
Właściwości parametru
Zestawy parametrów
SetByIpConfigurationResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-NetworkSecurityGroupId
Określa identyfikator sieciowej grupy zabezpieczeń.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByIpConfigurationResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-PrivateIpAddress
Określa statyczny adres IP IPv4 do przypisania do tego interfejsu sieciowego.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-PublicIpAddress
Określa obiekt PublicIPAddress do przypisania do interfejsu sieciowego.
Właściwości parametru
Typ: PSPublicIpAddress
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-PublicIpAddressId
Określa identyfikator obiektu PublicIPAddress , który ma zostać przypisany do interfejsu sieciowego.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-ResourceGroupName
Określa nazwę grupy zasobów, do którego należy interfejs sieciowy.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-Subnet
Określa obiekt podsieci .
To polecenie cmdlet tworzy interfejs sieciowy dla podsieci określonej przez ten parametr.
Właściwości parametru
Typ: PSSubnet
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResource
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-SubnetId
Określa identyfikator podsieci, dla której ma zostać utworzony interfejs sieciowy.
Właściwości parametru
Typ: String
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
SetByResourceId
Position: Named
Obowiązkowy: True
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-Tag
Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}
Właściwości parametru
Typ: Hashtable
Domyślna wartość: None
Obsługuje symbole wieloznaczne: False
DontShow: False
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: True
Wartość z pozostałych argumentów: False
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione.
Cmdlet nie jest uruchomiony.
Właściwości parametru
Typ: SwitchParameter
Domyślna wartość: False
Obsługuje symbole wieloznaczne: False
DontShow: False
Aliasy: Wi
Zestawy parametrów
(All)
Position: Named
Obowiązkowy: False
Wartość z potoku: False
Wartość z potoku według nazwy właściwości: False
Wartość z pozostałych argumentów: False
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters .
Dane wyjściowe