Set-AzNetworkInterfaceIpConfig

Aktualizacje 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

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.

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.

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.

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

-ApplicationGatewayBackendAddressPoolId

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

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

-ApplicationSecurityGroup

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

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

-ApplicationSecurityGroupId

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

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

-DefaultProfile

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

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

-GatewayLoadBalancerId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:PSBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:PSInboundNatRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Name

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

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

-NetworkInterface

Określa obiekt NetworkInterface . To polecenie cmdlet dodaje konfigurację adresu IP interfejsu sieciowego do obiektu, który określa ten 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

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

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

-PrivateIpAddressVersion

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

  • Protokół IPv4
  • Protokół IPv6
Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PublicIpAddressId

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

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

-Subnet

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

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

-SubnetId

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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