Udostępnij za pośrednictwem

Set-AzNetworkInterfaceIpConfig

  • Odwołanie
Moduł:
Az.Network

Aktualizuje konfigurację adresu IP dla interfejsu sieciowego.

Składnia

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

Opis

Polecenie cmdlet Set-AzNetworkInterfaceIpConfig aktualizuje konfigurację adresu IP dla interfejsu sieciowego.

Przykłady

Przykład 1. Zmiana adresu IP konfiguracji adresu 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

Dwa pierwsze polecenia pobierają sieć wirtualną o nazwie myvnet i podsieć o nazwie mysubnet i przechowują ją odpowiednio w zmiennych $vnet i $subnet. Trzecie polecenie pobiera interfejs sieciowy nic1 skojarzony z konfiguracją adresu IP, która musi zostać zaktualizowana. Trzecie polecenie ustawia prywatny adres IP podstawowej konfiguracji ipconfig1 na 10.0.0.11. Na koniec ostatnie polecenie aktualizuje interfejs sieciowy, upewniając się, że zmiany zostały wprowadzone pomyślnie.

Przykład 2. Kojarzenie konfiguracji adresu IP z grupą zabezpieczeń aplikacji

$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

W tym przykładzie zmienna $asg zawiera odwołanie do grupy zabezpieczeń aplikacji. Czwarte polecenie pobiera interfejs sieciowy nic1 skojarzony z konfiguracją adresu IP, która musi zostać zaktualizowana. Polecenie Set-AzNetworkInterfaceIpConfig ustawia prywatny adres IP podstawowej konfiguracji ipconfig1 na 10.0.0.11 i tworzy skojarzenie z pobraną grupą zabezpieczeń aplikacji. Na koniec ostatnie polecenie aktualizuje interfejs sieciowy, upewniając się, że zmiany zostały wprowadzone pomyślnie.

Przykład 3. Usuwanie skojarzenia konfiguracji adresu IP z pulą adresów zaplecza bramy aplikacji

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

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

$nic | Set-AzNetworkInterface

Polecenie Set-AzNetworkInterfaceIpConfig ustawia pulę adresów zaplecza bramy aplikacji ipconfig1 na wartość null i usuń skojarzenie z interfejsem sieciowym. Na koniec ostatnie polecenie aktualizuje interfejs sieciowy, upewniając się, że zmiany zostały wprowadzone pomyślnie.

Parametry

-ApplicationGatewayBackendAddressPool

Określa kolekcję puli adresów zaplecza bramy aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:PSApplicationGatewayBackendAddressPool[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationGatewayBackendAddressPoolId

Określa kolekcję puli adresów zaplecza bramy aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationSecurityGroup

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:PSApplicationSecurityGroup[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ApplicationSecurityGroupId

Określa kolekcję odwołań do grupy zabezpieczeń aplikacji, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GatewayLoadBalancerId

Określa identyfikator konfiguracji adresu IP dostawcy usługi równoważenia obciążenia bramy.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerBackendAddressPool

Określa kolekcję puli adresów zaplecza modułu równoważenia obciążenia, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:PSBackendAddressPool[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerBackendAddressPoolId

Określa kolekcję puli adresów zaplecza modułu równoważenia obciążenia, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerInboundNatRule

Określa kolekcję reguł translatora adresów sieciowych (NAT) dla ruchu przychodzącego modułu równoważenia obciążenia, do których należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:PSInboundNatRule[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-LoadBalancerInboundNatRuleId

Określa kolekcję reguł NAT dla ruchu przychodzącego modułu równoważenia obciążenia, do której należy ta konfiguracja adresu IP interfejsu sieciowego.

Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę konfiguracji adresu IP sieci, dla której to polecenie cmdlet ustawia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NetworkInterface

Określa obiekt NetworkInterface . To polecenie cmdlet dodaje konfigurację adresu IP interfejsu sieciowego do obiektu, który określa ten parametr.

Typ:PSNetworkInterface
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Primary

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrivateIpAddress

Określa statyczny adres IP konfiguracji adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PrivateIpAddressVersion

Określa wersję adresu IP konfiguracji adresu IP interfejsu sieciowego. Dopuszczalne wartości tego parametru to:

  • Protokół IPv4
  • Protokół IPv6
Typ:String
Dopuszczalne wartości:IPv4, IPv6
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIpAddress

Określa obiekt PublicIPAddress . To polecenie cmdlet tworzy odwołanie do publicznego adresu IP w celu skojarzenia z tą konfiguracją adresu IP interfejsu sieciowego.

Typ:PSPublicIpAddress
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicIpAddressId

To polecenie cmdlet tworzy odwołanie do publicznego adresu IP w celu skojarzenia z tą konfiguracją adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Subnet

Określa obiekt podsieci. To polecenie cmdlet tworzy odwołanie do podsieci, w której jest tworzona konfiguracja adresu IP interfejsu sieciowego.

Typ:PSSubnet
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubnetId

To polecenie cmdlet tworzy odwołanie do podsieci, w której jest tworzona konfiguracja adresu IP interfejsu sieciowego.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Dane wyjściowe

PSNetworkInterface

Uwagi

  • Słowa kluczowe: azure, azurerm, arm, resource, management, manager, network, networking