Set-AzNetworkInterfaceIpConfig
Aggiornamenti una configurazione IP per un'interfaccia di rete.
Sintassi
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>]
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
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.
2: Associazione di una configurazione IP a un gruppo di sicurezza dell'applicazione
$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. 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.
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
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.
Type: | PSApplicationGatewayBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
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 appartiene questa 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 appartiene questa configurazione IP dell'interfaccia di rete.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
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 |
-GatewayLoadBalancerId
Specifica l'ID della configurazione ip front-end del provider di bilanciamento del carico del gateway.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | PSBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | PSInboundNatRule[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Specifica il nome della configurazione IP di rete per cui viene impostato questo cmdlet.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NetworkInterface
Specifica un oggetto NetworkInterface . Questo cmdlet aggiunge una configurazione IP dell'interfaccia di rete all'oggetto specificato da questo parametro.
Type: | PSNetworkInterface |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Primary
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIpAddress
Specifica l'indirizzo IP statico della configurazione IP dell'interfaccia di rete.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | String |
Accepted values: | IPv4, IPv6 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSPublicIpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIpAddressId
Questo cmdlet crea un riferimento a un indirizzo IP pubblico da associare a questa configurazione IP dell'interfaccia di rete.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | PSSubnet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Questo cmdlet crea un riferimento a una subnet in cui viene creata questa configurazione IP dell'interfaccia di rete.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Input
String[]
PSApplicationGatewayBackendAddressPool[]
Output
Note
- Parole chiave: azure, azurerm, arm, resource, management, manager, rete, rete