Udostępnij przez

Set-AzNetworkInterfaceIpConfig

Moduł:
Az.Network Module

Aktualizuje konfigurację adresu IP dla interfejsu sieciowego.

Składnia

SetByResource (Domyślne) 

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

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

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.

Właściwości parametrów

Typ:

PSApplicationGatewayBackendAddressPool[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ApplicationGatewayBackendAddressPoolId

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

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ApplicationSecurityGroup

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

Właściwości parametrów

Typ:

PSApplicationSecurityGroup[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-ApplicationSecurityGroupId

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

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:IAzureContextContainer
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-GatewayLoadBalancerId

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

PSBackendAddressPool[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

PSInboundNatRule[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:True
Wartość pozostałych argumentów:False

-Name

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-NetworkInterface

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

Właściwości parametrów

Typ:PSNetworkInterface
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:True
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Primary

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PrivateIpAddress

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6

Właściwości parametrów

Typ:String
Wartość domyślna:None
Akceptowane wartości:IPv4, IPv6
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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.

Właściwości parametrów

Typ:PSPublicIpAddress
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-PublicIpAddressId

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Subnet

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

Właściwości parametrów

Typ:PSSubnet
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResource
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-SubnetId

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SetByResourceId
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Wejścia

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Wyjść

PSNetworkInterface

Notatki

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