Condividi tramite

Set-AzNetworkInterfaceIpConfig

Modulo:
Az.Network Module

Aggiorna una configurazione IP per un'interfaccia di rete.

Sintassi

SetByResource (impostazione predefinita). 

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

SetByResourceId 

Set-AzNetworkInterfaceIpConfig
    -Name <String>
    -NetworkInterface <PSNetworkInterface>
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-SubnetId <String>]
    [-PublicIpAddressId <String>]
    [-LoadBalancerBackendAddressPoolId <String[]>]
    [-LoadBalancerInboundNatRuleId <String[]>]
    [-ApplicationGatewayBackendAddressPoolId <String[]>]
    [-ApplicationSecurityGroupId <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet Set-AzNetworkInterfaceIpConfig aggiorna una configurazione IP per un'interfaccia di rete.

Esempio

Esempio 1: Modifica dell'indirizzo IP di una configurazione IP

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

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

I primi due comandi ottengono una rete virtuale denominata myvnet e una subnet denominata mysubnet e archiviarla rispettivamente nelle variabili $vnet e $subnet. Il terzo comando ottiene l'interfaccia di rete nic1 associata alla configurazione IP che deve essere aggiornata. Il terzo comando imposta l'indirizzo IP privato della configurazione IP primaria ipconfig1 su 10.0.0.11. Infine, l'ultimo comando aggiorna l'interfaccia di rete verificando che le modifiche siano state apportate correttamente.

Esempio 2: Associazione di una configurazione IP a un gruppo di sicurezza delle applicazioni

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

In questo esempio la variabile $asg contiene un riferimento a un gruppo di sicurezza delle applicazioni. Il quarto comando ottiene l'interfaccia di rete nic1 associata alla configurazione IP che deve essere aggiornata. Il Set-AzNetworkInterfaceIpConfig imposta l'indirizzo IP privato della configurazione IP primaria ipconfig1 su 10.0.0.11 e crea un'associazione con il gruppo di sicurezza delle applicazioni recuperato. Infine, l'ultimo comando aggiorna l'interfaccia di rete verificando che le modifiche siano state apportate correttamente.

Esempio 3: Annullare l'associazione di una configurazione IP con un pool di indirizzi back-end del gateway applicazione

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

Il Set-AzNetworkInterfaceIpConfig imposta il pool di indirizzi back-end del gateway applicazione della configurazione IP ipconfig1 su null e disassociare con l'interfaccia di rete. Infine, l'ultimo comando aggiorna l'interfaccia di rete verificando che le modifiche siano state apportate correttamente.

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

Specifica l'ID della configurazione ip front-end del provider di bilanciamento del carico del gateway.

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 (Network Address Translation) del servizio di bilanciamento del carico a cui appartiene questa configurazione IP dell'interfaccia di rete.

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 in ingresso 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 di rete per cui viene impostato questo cmdlet.

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

-NetworkInterface

Specifica un oggetto NetworkInterface . Questo cmdlet aggiunge una configurazione IP dell'interfaccia di rete all'oggetto specificato da questo parametro.

Proprietà dei parametri

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

Set di parametri

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

-Primary

Il cmdlet Set-AzNetworkInterfaceIpConfig aggiorna una configurazione IP 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

-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

Questo cmdlet crea un riferimento a una subnet in cui viene creata 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

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

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Output

PSNetworkInterface

Note

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