Condividi tramite

New-AzNetworkInterface

  • Riferimento
Modulo:
Az.Network

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 .

Tipo:PSApplicationGatewayBackendAddressPool[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ApplicationGatewayBackendAddressPoolId

Specifica l'ID di un oggetto ApplicationGatewayBackendAddressPool .

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ApplicationSecurityGroup

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

Tipo:PSApplicationSecurityGroup[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ApplicationSecurityGroupId

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AuxiliaryMode

Modalità ausiliaria dell'interfaccia di rete

Tipo:String
Valori accettati:None, MaxConnections, AcceleratedConnections, Floating
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AuxiliarySku

SKU ausiliario dell'interfaccia di rete

Tipo:String
Valori accettati:None, A1, A2, A4, A8
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableTcpStateTracking

Indica se disabilitare il rilevamento dello stato tcp.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DnsServer

Specifica il server DNS per l'interfaccia di rete.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EdgeZone

Zona perimetrale dell'interfaccia di rete

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-EnableAcceleratedNetworking

Abilita la rete accelerata.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InternalDnsNameLabel

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpConfiguration

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

Tipo:PSNetworkInterfaceIPConfiguration[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpConfigurationName

Specifica il nome di una configurazione IP.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LoadBalancerBackendAddressPool

Specifica un oggetto BackendAddressPool .

Tipo:PSBackendAddressPool[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LoadBalancerBackendAddressPoolId

Specifica l'ID di un oggetto BackendAddressPool .

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LoadBalancerInboundNatRule

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

Tipo:PSInboundNatRule[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LoadBalancerInboundNatRuleId

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

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Location

Specifica l'area per un'interfaccia di rete.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome dell'interfaccia di rete da creare.

Tipo:String
Alias:ResourceName
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NetworkSecurityGroup

Specifica un oggetto NetworkSecurityGroup .

Tipo:PSNetworkSecurityGroup
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NetworkSecurityGroupId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PrivateIpAddress

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PublicIpAddress

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

Tipo:PSPublicIpAddress
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PublicIpAddressId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Subnet

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

Tipo:PSSubnet
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SubnetId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Tag

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

Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

PSNetworkInterfaceIPConfiguration[]

PSSubnet

PSPublicIpAddress

PSNetworkSecurityGroup

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Hashtable

Output

PSNetworkInterface