Dela via

New-AzNetworkInterface

Modul:
Az.Network Module

Skapar ett nätverksgränssnitt.

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

Description

Cmdleten New-AzNetworkInterface skapar ett Azure-nätverksgränssnitt.

Exempel

Exempel 1: Skapa ett Azure-nätverksgränssnitt

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"

Det här kommandot skapar ett nätverksgränssnitt med namnet NetworkInterface001 med en dynamiskt tilldelad privat IP-adress från Undernät1 i det virtuella nätverket med namnet VirtualNetwork1. Kommandot tilldelar också två DNS-servrar till nätverksgränssnittet. Den underordnade IPConfiguration-resursen skapas automatiskt med namnet IPConfiguration1.

Exempel 2: Skapa ett Azure-nätverksgränssnitt med hjälp av ett IP-konfigurationsobjekt

$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

I det här exemplet skapas ett nytt nätverksgränssnitt med hjälp av ett IP-konfigurationsobjekt. IP-konfigurationsobjektet anger en statisk privat IPv4-adress. Det första kommandot hämtar ett befintligt angivet virtuellt nätverk som används för att tilldela undernätet i det andra kommandot. Det andra kommandot skapar en IP-konfiguration för nätverksgränssnittet med namnet IPConfig1 och lagrar konfigurationen i variabeln med namnet $IPconfig. Det tredje kommandot skapar ett nätverksgränssnitt med namnet NetworkInterface1 som använder IP-konfigurationen för nätverksgränssnittet som lagras i variabeln med namnet $IPconfig.

Exempel 3

Skapar ett nätverksgränssnitt. (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'

Parametrar

-ApplicationGatewayBackendAddressPool

Anger ett ApplicationGatewayBackendAddressPool-objekt .

Parameteregenskaper

Typ:

PSApplicationGatewayBackendAddressPool[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationGatewayBackendAddressPoolId

Anger ID för ett ApplicationGatewayBackendAddressPool-objekt .

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationSecurityGroup

Anger en samling programsäkerhetsgruppreferenser som IP-konfigurationen för nätverksgränssnittet ska tillhöra.

Parameteregenskaper

Typ:

PSApplicationSecurityGroup[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ApplicationSecurityGroupId

Anger en samling programsäkerhetsgruppreferenser som IP-konfigurationen för nätverksgränssnittet ska tillhöra.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-AsJob

Kör cmdlet i bakgrunden

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AuxiliaryMode

Extraläget för nätverksgränssnittet

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:None, MaxConnections, AcceleratedConnections, Floating
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-AuxiliarySku

Den extra SKU:n för nätverksgränssnittet

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:None, A1, A2, A4, A8
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DisableTcpStateTracking

Anger om tcp-tillståndsspårning ska inaktiveras.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-DnsServer

Anger DNS-servern för nätverksgränssnittet.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-EdgeZone

Gränszonen för nätverksgränssnittet

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-EnableAcceleratedNetworking

Aktiverar accelererat nätverk.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-EnableIPForwarding

Anger att den här cmdleten aktiverar IP-vidarebefordran för nätverksgränssnittet. Med IP-vidarebefordran kan en virtuell dator ta emot trafik som är adresserad till andra mål.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Tvingar fram skapandet av nätverksgränssnittet även om det redan finns ett nätverksgränssnitt med samma namn.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-InternalDnsNameLabel

Anger den interna DNS-namnetiketten för det nya nätverksgränssnittet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IpConfiguration

Anger den IP-konfiguration som den här cmdleten använder för nätverksgränssnittet.

Parameteregenskaper

Typ:

PSNetworkInterfaceIPConfiguration[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByIpConfigurationResource
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetByIpConfigurationResourceId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-IpConfigurationName

Anger namnet på en IP-konfiguration.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerBackendAddressPool

Anger ett BackendAddressPool-objekt .

Parameteregenskaper

Typ:

PSBackendAddressPool[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerBackendAddressPoolId

Anger ID för ett BackendAddressPool-objekt .

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerInboundNatRule

Anger en inkommande NAT-regelkonfiguration för en lastbalanserare.

Parameteregenskaper

Typ:

PSInboundNatRule[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-LoadBalancerInboundNatRuleId

Anger ID för en inkommande NAT-regelkonfiguration för en lastbalanserare.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Location

Anger regionen för ett nätverksgränssnitt.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Anger namnet på nätverksgränssnittet som ska skapas.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Resursnamn

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NetworkSecurityGroup

Anger ett NetworkSecurityGroup-objekt .

Parameteregenskaper

Typ:PSNetworkSecurityGroup
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByIpConfigurationResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-NetworkSecurityGroupId

Anger ID för en nätverkssäkerhetsgrupp.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByIpConfigurationResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PrivateIpAddress

Anger en statisk IP-adress för IPv4 som ska tilldelas till det här nätverksgränssnittet.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False
SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PublicIpAddress

Anger ett PublicIPAddress-objekt som ska tilldelas till ett nätverksgränssnitt.

Parameteregenskaper

Typ:PSPublicIpAddress
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-PublicIpAddressId

Anger ID för ett PublicIPAddress-objekt som ska tilldelas till ett nätverksgränssnitt.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-ResourceGroupName

Anger namnet på en resursgrupp som nätverksgränssnittet tillhör.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Subnet

Anger ett undernätsobjekt . Den här cmdleten skapar ett nätverksgränssnitt för det undernät som den här parametern anger.

Parameteregenskaper

Typ:PSSubnet
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-SubnetId

Anger ID för det undernät som du vill skapa ett nätverksgränssnitt för.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

Parameteregenskaper

Typ:Hashtable
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

PSNetworkInterfaceIPConfiguration

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Hashtable

Utdata

PSNetworkInterface