New-AzNetworkInterface

Crea un'interfaccia di rete.

Sintassi

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

Descrizione

Il cmdlet New-AzNetworkInterface crea un'interfaccia di rete di Azure.

Esempio

Esempio 1: Creare un'interfaccia di rete di 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"

Questo comando crea un'interfaccia di rete denominata NetworkInterface001 con un indirizzo IP privato assegnato dinamicamente da Subnet1 nella rete virtuale denominata VirtualNetwork1. Il comando assegna anche due server DNS all'interfaccia di rete. La risorsa figlio IPConfiguration verrà creata automaticamente usando il nome IPConfiguration1.

Esempio 2: Creare un'interfaccia di rete di Azure usando un oggetto di configurazione 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

In questo esempio viene creata una nuova interfaccia di rete usando un oggetto di configurazione IP. L'oggetto di configurazione IP specifica un indirizzo IPv4 privato statico. Il primo comando recupera una rete virtuale specificata esistente usata per assegnare la subnet nel secondo comando. Il secondo comando crea una configurazione IP dell'interfaccia di rete denominata IPConfig1 e archivia la configurazione nella variabile denominata $IPconfig. Il terzo comando crea un'interfaccia di rete denominata NetworkInterface1 che usa la configurazione IP dell'interfaccia di rete archiviata nella variabile denominata $IPconfig.

Esempio 3

Crea un'interfaccia di rete. (generato automaticamente)

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'

Parametri

-ApplicationGatewayBackendAddressPool

Specifica un oggetto ApplicationGatewayBackendAddressPool .

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

-ApplicationGatewayBackendAddressPoolId

Specifica l'ID di un oggetto ApplicationGatewayBackendAddressPool .

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

-ApplicationSecurityGroup

Specifica una raccolta di riferimenti al gruppo di sicurezza delle applicazioni a cui deve appartenere la configurazione IP dell'interfaccia di rete.

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

-ApplicationSecurityGroupId

Specifica una raccolta di riferimenti al gruppo di sicurezza delle applicazioni a cui deve appartenere la configurazione IP dell'interfaccia di rete.

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

-AsJob

Eseguire il cmdlet in background

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

-AuxiliaryMode

Modalità ausiliaria dell'interfaccia di rete

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

-AuxiliarySku

SKU ausiliario dell'interfaccia di rete

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

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-DisableTcpStateTracking

Indica se disabilitare il rilevamento dello stato tcp.

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

-DnsServer

Specifica il server DNS per l'interfaccia di rete.

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

-EdgeZone

Zona perimetrale dell'interfaccia di rete

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

-EnableAcceleratedNetworking

Abilita la rete accelerata.

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

-EnableIPForwarding

Indica che questo cmdlet abilita l'inoltro IP per l'interfaccia di rete. L'inoltro IP consente a una macchina virtuale di ricevere il traffico indirizzato ad altre destinazioni.

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

-Force

Forza la creazione dell'interfaccia di rete anche se esiste già un'interfaccia di rete con lo stesso nome.

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

-InternalDnsNameLabel

Specifica l'etichetta del nome DNS interna per la nuova interfaccia di rete.

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

-IpConfiguration

Specifica la configurazione IP usata da questo cmdlet per l'interfaccia di rete.

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

-IpConfigurationName

Specifica il nome di una configurazione IP.

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

-LoadBalancerBackendAddressPool

Specifica un oggetto BackendAddressPool .

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

-LoadBalancerBackendAddressPoolId

Specifica l'ID di un oggetto BackendAddressPool .

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

-LoadBalancerInboundNatRule

Specifica una configurazione della regola NAT in ingresso per un servizio di bilanciamento del carico.

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

-LoadBalancerInboundNatRuleId

Specifica l'ID di una configurazione della regola NAT in ingresso per un servizio di bilanciamento del carico.

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

-Location

Specifica l'area per un'interfaccia di rete.

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

-Name

Specifica il nome dell'interfaccia di rete da creare.

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

-NetworkSecurityGroup

Specifica un oggetto NetworkSecurityGroup .

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

-NetworkSecurityGroupId

Specifica l'ID di un gruppo di sicurezza di rete.

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

-PrivateIpAddress

Specifica un indirizzo IP IPv4 statico da assegnare a questa interfaccia di rete.

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

-PublicIpAddress

Specifica un oggetto PublicIPAddress da assegnare a un'interfaccia di rete.

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

-PublicIpAddressId

Specifica l'ID di un oggetto PublicIPAddress da assegnare a un'interfaccia di rete.

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

-ResourceGroupName

Specifica il nome di un gruppo di risorse a cui appartiene l'interfaccia di rete.

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

-Subnet

Specifica un oggetto Subnet . Questo cmdlet crea un'interfaccia di rete per la subnet specificata da questo parametro.

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

-SubnetId

Specifica l'ID della subnet per cui creare un'interfaccia di rete.

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

-Tag

Coppie chiave-valore sotto forma di tabella hash. Ad esempio: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

Output

PSNetworkInterface