Set-AzNetworkInterfaceIpConfig

Modul:

Az.Network Module

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

Syntax

SetByResource (Výchozí)

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

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

Příklady

Příklad 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.

Příklad 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.

Příklad 3: Zrušení přidružení konfigurace IP adresy 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 služby Application Gateway konfigurace IPconfig1 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í.

Vlastnosti parametru

Typ:	PSApplicationGatewayBackendAddressPool[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ApplicationSecurityGroup

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

Vlastnosti parametru

Typ:	PSApplicationSecurityGroup[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ApplicationSecurityGroupId

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

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

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-GatewayLoadBalancerId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSBackendAddressPool[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSInboundNatRule[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-NetworkInterface

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

Vlastnosti parametru

Typ:	PSNetworkInterface
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Primary

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateIpAddress

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PrivateIpAddressVersion

Určuje verzi IP adresy konfigurace PROTOKOLU IP síťového rozhraní. Přijatelné hodnoty pro tento parametr jsou:

• protokol IPv4
• protokol IPv6

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	IPv4, IPv6
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSPublicIpAddress
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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í.

Vlastnosti parametru

Typ:	PSSubnet
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResource

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SubnetId

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SetByResourceId

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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