Condividi tramite

New-AzNetworkInterfaceIpConfig

Modulo:
Az.Network Module

Crea una configurazione IP dell'interfaccia di rete.

Sintassi

SetByResource (impostazione predefinita). 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet New-AzNetworkInterfaceIpConfig crea una configurazione IP dell'interfaccia di rete di Azure per un'interfaccia di rete.

Esempio

Esempio 1: Creare una configurazione IP con un indirizzo IP pubblico per un'interfaccia di rete

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"

$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1 -Primary

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig1

I primi due comandi ottengono una rete virtuale denominata myvnet e una subnet denominata rispettivamente mysubnet creata in precedenza. Questi vengono archiviati rispettivamente in $vnet e $Subnet. Il terzo comando ottiene un indirizzo IP pubblico creato in precedenza denominato PIP1. Il comando forth crea una nuova configurazione IP denominata "IPConfig-1" come configurazione IP primaria con un indirizzo IP pubblico associato. L'ultimo comando crea quindi un'interfaccia di rete denominata mynic1 usando questa configurazione IP.

Esempio 2: Creare una configurazione IP con un indirizzo IP privato

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress 10.0.0.5

$nic = New-AzNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration $IpConfig2

I primi due comandi ottengono una rete virtuale denominata myvnet e una subnet denominata rispettivamente mysubnet creata in precedenza. Questi vengono archiviati rispettivamente in $vnet e $Subnet. Il terzo comando crea una nuova configurazione IP denominata "IPConfig-2" con un indirizzo IP privato 10.0.0.5 associato. L'ultimo comando crea quindi un'interfaccia di rete denominata mynic1 usando questa configurazione IP.

Esempio 3

Crea una configurazione IP dell'interfaccia di rete. (autogenerated)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

Parametri

-ApplicationGatewayBackendAddressPool

Specifica una raccolta di riferimenti al pool di indirizzi back-end del gateway applicazione a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

PSApplicationGatewayBackendAddressPool[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ApplicationGatewayBackendAddressPoolId

Specifica una raccolta di riferimenti al pool di indirizzi back-end del gateway applicazione a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ApplicationSecurityGroup

Specifica una raccolta di riferimenti al gruppo di sicurezza delle applicazioni a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

PSApplicationSecurityGroup[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ApplicationSecurityGroupId

Specifica una raccolta di riferimenti al gruppo di sicurezza delle applicazioni a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

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

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-GatewayLoadBalancerId

Riferimento alla risorsa del provider di Gateway LoadBalancer.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-LoadBalancerBackendAddressPool

Specifica una raccolta di riferimenti al pool di indirizzi back-end del servizio di bilanciamento del carico a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

PSBackendAddressPool[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-LoadBalancerBackendAddressPoolId

Specifica una raccolta di riferimenti al pool di indirizzi back-end del servizio di bilanciamento del carico a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-LoadBalancerInboundNatRule

Specifica una raccolta di riferimenti alle regole NAT in ingresso del servizio di bilanciamento del carico a cui appartiene questa interfaccia di rete IPConfiguration.

Proprietà dei parametri

Tipo:

PSInboundNatRule[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-LoadBalancerInboundNatRuleId

Specifica una raccolta di riferimenti alle regole NAT (Network Address Translation) del servizio di bilanciamento del carico a cui appartiene questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

Specifica il nome della configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Primary

Il cmdlet New-AzNetworkInterfaceIpConfig crea una configurazione IP dell'interfaccia di rete di Azure per un'interfaccia di rete.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrivateIpAddress

Specifica l'indirizzo IP statico della configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrivateIPAddressPrefixLength

Specifica la lunghezza del prefisso dell'indirizzo IP statico della configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrivateIpAddressVersion

Specifica la versione dell'indirizzo IP di una configurazione IP dell'interfaccia di rete. I valori accettabili per questo parametro sono:

  • IPv4
  • IPv6

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:IPv4, IPv6
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PublicIpAddress

Specifica un oggetto PublicIPAddress . Questo cmdlet crea un riferimento a un indirizzo IP pubblico da associare a questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:PSPublicIpAddress
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PublicIpAddressId

Questo cmdlet crea un riferimento a un indirizzo IP pubblico da associare a questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Subnet

Specifica un oggetto Subnet . Questo cmdlet crea un riferimento a una subnet in cui viene creata questa configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:PSSubnet
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResource
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SubnetId

Specifica un riferimento a una subnet in cui viene creata la configurazione IP dell'interfaccia di rete.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

SetByResourceId
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Output

PSNetworkInterfaceIPConfiguration

Note

  • Parole chiave: azure, azurerm, arm, resource, management, manager, rete, rete