Set-AzNetworkInterfaceIpConfig

Modul:

Az.Network

Aktualizace konfiguraci PROTOKOLU IP pro síťové rozhraní.

Syntax

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

Rutina Set-AzNetworkInterfaceIpConfig aktualizuje konfiguraci PROTOKOLU IP pro síťové rozhraní.

Příklady

1: Změna IP adresy konfigurace PROTOKOLU 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

První dva příkazy získají virtuální síť s názvem myvnet a podsíť s názvem mysubnet a uloží ji do proměnných $vnet a $subnet. Třetí příkaz získá síťové rozhraní nic1 přidružené ke konfiguraci PROTOKOLU IP, kterou je potřeba aktualizovat. Třetí příkaz nastaví privátní IP adresu primární konfigurace IPconfig1 na 10.0.0.11. Poslední příkaz nakonec aktualizuje síťové rozhraní, aby se změny úspěšně provedly.

2: Přidružení konfigurace PROTOKOLU IP ke skupině zabezpečení aplikace

$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

V tomto příkladu obsahuje proměnná $asg odkaz na skupinu zabezpečení aplikace. Čtvrtý příkaz získá síťové rozhraní nic1 přidružené ke konfiguraci PROTOKOLU IP, kterou je potřeba aktualizovat. Set-AzNetworkInterfaceIpConfig nastaví privátní IP adresu primární konfigurace IPconfig1 na 10.0.0.11 a vytvoří přidružení k načtené skupině zabezpečení aplikace. Poslední příkaz nakonec aktualizuje síťové rozhraní, aby se změny úspěšně provedly.

3: Zrušení přidružení konfigurace PROTOKOLU IP k back-endovému fondu adres služby Application Gateway

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

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

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig nastaví back-endový fond adres aplikační brány ipconfig1 konfigurace PROTOKOLU IP na hodnotu null a zruší přidružení k síťovému rozhraní. Poslední příkaz nakonec aktualizuje síťové rozhraní, aby se změny úspěšně provedly.

Parametry

-ApplicationGatewayBackendAddressPool

Určuje kolekci back-endového fondu adres služby Application Gateway, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	PSApplicationGatewayBackendAddressPool[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationGatewayBackendAddressPoolId

Určuje kolekci back-endového fondu adres služby Application Gateway, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroup

Určuje kolekci odkazů na skupinu zabezpečení aplikace, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	PSApplicationSecurityGroup[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ApplicationSecurityGroupId

Určuje kolekci odkazů na skupinu zabezpečení aplikace, do které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-GatewayLoadBalancerId

Určuje ID konfigurace front-endové IP adresy poskytovatele nástroje pro vyrovnávání zatížení brány.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPool

Určuje kolekci odkazů back-endového fondu adres nástroje pro vyrovnávání zatížení, do kterého patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	PSBackendAddressPool[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerBackendAddressPoolId

Určuje kolekci odkazů back-endového fondu adres nástroje pro vyrovnávání zatížení, do kterého patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRule

Určuje kolekci příchozích pravidel překladu síťových adres (NAT) nástroje pro vyrovnávání zatížení, na které patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	PSInboundNatRule[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-LoadBalancerInboundNatRuleId

Určuje kolekci příchozích pravidel překladu adres (NAT) nástroje pro vyrovnávání zatížení, do kterých patří tato konfigurace PROTOKOLU IP síťového rozhraní.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Určuje název konfigurace protokolu IP sítě, pro kterou se tato rutina nastavuje.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkInterface

Určuje Objekt NetworkInterface . Tato rutina přidá konfiguraci protokolu IP síťového rozhraní k objektu, který určuje tento parametr.

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

Určuje statickou IP adresu konfigurace protokolu IP síťového rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrivateIpAddressVersion

Určuje verzi IP adresy konfigurace PROTOKOLU IP síťového rozhraní. Tento parametr přijímá tyto hodnoty:

• IPv4
• IPv6

Type:	String
Accepted values:	IPv4, IPv6
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicIpAddress

Určuje objekt PublicIPAddress . Tato rutina vytvoří odkaz na veřejnou IP adresu, která se přidruží k této konfiguraci PROTOKOLU IP síťového rozhraní.

Type:	PSPublicIpAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicIpAddressId

Tato rutina vytvoří odkaz na veřejnou IP adresu, která se přidruží k této konfiguraci PROTOKOLU IP síťového rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Subnet

Určuje objekt podsítě . Tato rutina vytvoří odkaz na podsíť, ve které se vytvoří konfigurace PROTOKOLU IP tohoto síťového rozhraní.

Type:	PSSubnet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

Tato rutina vytvoří odkaz na podsíť, ve které se vytvoří konfigurace PROTOKOLU IP tohoto síťového rozhraní.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Výstupy

PSNetworkInterface

Poznámky

• Klíčová slova: azure, azurerm, arm, resource, management, manager, network, networking

Související odkazy

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• New-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig