Sdílet prostřednictvím

Set-AzureRmNetworkInterfaceIpConfig

  • Reference
Modul:
AzureRM.Network

Nastaví stav cíle pro konfiguraci IP adresy síťového rozhraní Azure.

Upozorňující

Modul AzureRM PowerShell je od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Rutina Set-AzureRmNetworkInterfaceIpConfig nastaví stav cíle pro konfiguraci PROTOKOLU IP síťového rozhraní Azure.

Příklady

1: Změna IP adresy konfigurace PROTOKOLU IP

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
    -Primary

$nic | Set-AzureRmNetworkInterface

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-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

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

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
    -Primary

$nic | Set-AzureRmNetworkInterface

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-AzureRmNetworkInterfaceIpConfig 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.

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í.

Typ:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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í.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationSecurityGroup

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

Typ:List<T>[PSApplicationSecurityGroup]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ApplicationSecurityGroupId

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

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:List<T>[PSBackendAddressPool]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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í.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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í.

Typ:List<T>[PSInboundNatRule]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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í.

Typ:List<T>[String]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

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

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NetworkInterface

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

Typ:PSNetworkInterface
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Primary

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrivateIpAddress

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
Typ:String
Přípustné hodnoty:IPv4, IPv6
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:PSPublicIpAddress
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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í.

Typ:PSSubnet
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SubnetId

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSNetworkInterface

Parametry: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Výstupy

PSNetworkInterface

Poznámky

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