Delen via

Set-AzNetworkInterfaceIpConfig

  • Referentie
Module:
Az.Network

Hiermee werkt u een IP-configuratie voor een netwerkinterface bij.

Syntaxis

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>]

Description

De cmdlet Set-AzNetworkInterfaceIpConfig werkt een IP-configuratie voor een netwerkinterface bij.

Voorbeelden

Voorbeeld 1: het IP-adres van een IP-configuratie wijzigen

$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

Met de eerste twee opdrachten krijgt u een virtueel netwerk met de naam myvnet en een subnet met de naam mysubnet en slaat u het op in respectievelijk de variabelen $vnet en $subnet. Met de derde opdracht wordt de netwerkinterface-nic1 die is gekoppeld aan de IP-configuratie die moet worden bijgewerkt, ophaalt. Met de derde opdracht stelt u het privé-IP-adres van de primaire IP-configuratie ipconfig1 in op 10.0.0.11. Ten slotte werkt de laatste opdracht de netwerkinterface bij zodat de wijzigingen zijn aangebracht.

Voorbeeld 2: Een IP-configuratie koppelen aan een toepassingsbeveiligingsgroep

$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 dit voorbeeld bevat de variabele $asg een verwijzing naar een toepassingsbeveiligingsgroep. De vierde opdracht haalt de netwerkinterface-nic1 op die is gekoppeld aan de IP-configuratie die moet worden bijgewerkt. De Set-AzNetworkInterfaceIpConfig stelt het privé-IP-adres van de primaire IP-configuratie ipconfig1 in op 10.0.0.11 en maakt een koppeling met de opgehaalde toepassingsbeveiligingsgroep. Ten slotte werkt de laatste opdracht de netwerkinterface bij zodat de wijzigingen zijn aangebracht.

Voorbeeld 3: Een IP-configuratie ontkoppelen met een back-endadresgroep van de toepassingsgateway

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

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

$nic | Set-AzNetworkInterface

Met Set-AzNetworkInterfaceIpConfig stelt u de back-endadresgroep van de toepassingsgateway van de IP-configuratie ipconfig1 in op null en ontkoppelt u deze met de netwerkinterface. Ten slotte werkt de laatste opdracht de netwerkinterface bij zodat de wijzigingen zijn aangebracht.

Parameters

-ApplicationGatewayBackendAddressPool

Hiermee geeft u een verzameling back-endadresgroep van application gateway verwijzingen waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:PSApplicationGatewayBackendAddressPool[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ApplicationGatewayBackendAddressPoolId

Hiermee geeft u een verzameling back-endadresgroep van application gateway verwijzingen waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ApplicationSecurityGroup

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe deze IP-configuratie van de netwerkinterface behoort.

Type:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ApplicationSecurityGroupId

Hiermee geeft u een verzameling toepassingsbeveiligingsgroepverwijzingen op waartoe deze IP-configuratie van de netwerkinterface behoort.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GatewayLoadBalancerId

Hiermee geeft u de id van de front-end-IP-configuratie van de gateway load balancer-provider.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LoadBalancerBackendAddressPool

Hiermee geeft u een verzameling back-endadresgroepverwijzingen van load balancer waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:PSBackendAddressPool[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LoadBalancerBackendAddressPoolId

Hiermee geeft u een verzameling back-endadresgroepverwijzingen van load balancer waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LoadBalancerInboundNatRule

Hiermee geeft u een verzameling van binnenkomende NAT-regels (Network Address Translation) voor load balancer op waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:PSInboundNatRule[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-LoadBalancerInboundNatRuleId

Hiermee geeft u een verzameling van binnenkomende NAT-regels voor load balancer waarnaar deze IP-configuratie van de netwerkinterface behoort.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de netwerk-IP-configuratie waarvoor deze cmdlet wordt ingesteld.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkInterface

Hiermee geeft u een NetworkInterface-object . Met deze cmdlet wordt een IP-configuratie van de netwerkinterface toegevoegd aan het object dat met deze parameter wordt opgegeven.

Type:PSNetworkInterface
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Primary

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrivateIpAddress

Hiermee geeft u het statische IP-adres van de IP-configuratie van de netwerkinterface.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrivateIpAddressVersion

Hiermee geeft u de IP-adresversie van een IP-configuratie van een netwerkinterface. De aanvaardbare waarden voor deze parameter zijn:

  • IPv4
  • IPv6
Type:String
Geaccepteerde waarden:IPv4, IPv6
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicIpAddress

Hiermee geeft u een PublicIPAddress-object . Met deze cmdlet wordt een verwijzing gemaakt naar een openbaar IP-adres dat moet worden gekoppeld aan deze IP-configuratie van de netwerkinterface.

Type:PSPublicIpAddress
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PublicIpAddressId

Met deze cmdlet wordt een verwijzing gemaakt naar een openbaar IP-adres dat moet worden gekoppeld aan deze IP-configuratie van de netwerkinterface.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Subnet

Hiermee geeft u een Subnet-object . Met deze cmdlet maakt u een verwijzing naar een subnet waarin deze IP-configuratie van de netwerkinterface wordt gemaakt.

Type:PSSubnet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SubnetId

Met deze cmdlet maakt u een verwijzing naar een subnet waarin deze IP-configuratie van de netwerkinterface wordt gemaakt.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Uitvoerwaarden

PSNetworkInterface

Notities

  • Trefwoorden: azurerm, arm, resource, beheer, manager, netwerk, netwerken