Condividi tramite

Set-AzureRmNetworkInterfaceIpConfig

  • Riferimento
Modulo:
AzureRM.Network

Imposta lo stato dell'obiettivo per una configurazione IP dell'interfaccia di rete di Azure.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureRmNetworkInterfaceIpConfig imposta lo stato dell'obiettivo per una configurazione IP dell'interfaccia di rete di Azure.

Esempio

1: Modifica dell'indirizzo IP di una configurazione IP

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

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

$nic | Set-AzureRmNetworkInterface

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.

2: Associazione di una configurazione IP a un gruppo di sicurezza dell'applicazione

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

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

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

$nic | Set-AzureRmNetworkInterface

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. Set-AzureRmNetworkInterfaceIpConfig 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.

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.

Tipo:List<T>[PSApplicationGatewayBackendAddressPool]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:List<T>[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 appartiene questa configurazione IP dell'interfaccia di rete.

Tipo:List<T>[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 appartiene questa configurazione IP dell'interfaccia di rete.

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

-DefaultProfile

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

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

Tipo:List<T>[PSBackendAddressPool]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:List<T>[String]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

Tipo:List<T>[PSInboundNatRule]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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.

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

-Name

Specifica il nome della configurazione IP di rete per cui viene impostato questo cmdlet.

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

-NetworkInterface

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

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

-Primary

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

-PrivateIpAddress

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

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

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
Tipo:String
Valori accettati:IPv4, IPv6
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

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

-PublicIpAddressId

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

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

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

-SubnetId

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

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

Input

PSNetworkInterface

Parametri: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Output

PSNetworkInterface

Note

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