Delen via

Set-AzNetworkInterfaceIpConfig

Module:
Az.Network Module

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

Syntaxis

SetByResource (Standaard) 

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

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

De Set-AzNetworkInterfaceIpConfig stelt de back-endadresgroep van de toepassingsgateway van de IP-configuratie ipconfig1 in op null en koppelt deze los van 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.

Parametereigenschappen

Type:

PSApplicationGatewayBackendAddressPool[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationGatewayBackendAddressPoolId

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationSecurityGroup

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

Parametereigenschappen

Type:

PSApplicationSecurityGroup[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ApplicationSecurityGroupId

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-GatewayLoadBalancerId

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerBackendAddressPool

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

Parametereigenschappen

Type:

PSBackendAddressPool[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerBackendAddressPoolId

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

PSInboundNatRule[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-LoadBalancerInboundNatRuleId

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

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSNetworkInterface
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Primary

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateIpAddress

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6

Parametereigenschappen

Type:String
Default value:None
Geaccepteerde waarden:IPv4, IPv6
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSPublicIpAddress
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:PSSubnet
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResource
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SubnetId

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SetByResourceId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Uitvoerwaarden

PSNetworkInterface

Notities

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