Bagikan melalui

Set-AzNetworkInterfaceIpConfig

  • Referensi
Modul:
Az.Network

Memperbarui konfigurasi IP untuk antarmuka jaringan.

Sintaks

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

Deskripsi

Cmdlet Set-AzNetworkInterfaceIpConfig memperbarui konfigurasi IP untuk antarmuka jaringan.

Contoh

Contoh 1: Mengubah alamat IP konfigurasi 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

Dua perintah pertama mendapatkan jaringan virtual yang disebut myvnet dan subnet yang disebut mysubnet dan menyimpannya dalam variabel $vnet dan $subnet masing-masing. Perintah ketiga mendapatkan antarmuka jaringan nic1 yang terkait dengan konfigurasi IP yang perlu diperbarui. Perintah ketiga mengatur alamat IP privat dari konfigurasi IP utama ipconfig1 ke 10.0.0.11. Terakhir, perintah terakhir memperbarui antarmuka jaringan yang memastikan perubahan telah berhasil dibuat.

Contoh 2: Mengaitkan konfigurasi IP dengan grup keamanan aplikasi

$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

Dalam contoh ini, variabel $asg berisi referensi ke grup keamanan aplikasi. Perintah keempat mendapatkan antarmuka jaringan nic1 yang terkait dengan konfigurasi IP yang perlu diperbarui. Set-AzNetworkInterfaceIpConfig mengatur alamat IP privat dari konfigurasi IP utama ipconfig1 ke 10.0.0.11 dan membuat asosiasi dengan grup keamanan aplikasi yang diambil. Terakhir, perintah terakhir memperbarui antarmuka jaringan yang memastikan perubahan telah berhasil dibuat.

Contoh 3: Memisahkan konfigurasi IP dengan kumpulan alamat backend gateway aplikasi

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

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

$nic | Set-AzNetworkInterface

Set-AzNetworkInterfaceIpConfig mengatur kumpulan alamat backend gateway aplikasi dari konfigurasi IPconfig1 ke null dan disasosiasi dengan antarmuka jaringan. Terakhir, perintah terakhir memperbarui antarmuka jaringan yang memastikan perubahan telah berhasil dibuat.

Parameter

-ApplicationGatewayBackendAddressPool

Menentukan kumpulan referensi kumpulan alamat backend gateway aplikasi tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:PSApplicationGatewayBackendAddressPool[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ApplicationGatewayBackendAddressPoolId

Menentukan kumpulan referensi kumpulan alamat backend gateway aplikasi tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ApplicationSecurityGroup

Menentukan kumpulan referensi grup keamanan aplikasi tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:PSApplicationSecurityGroup[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ApplicationSecurityGroupId

Menentukan kumpulan referensi grup keamanan aplikasi tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-GatewayLoadBalancerId

Menentukan ID Konfigurasi Ip Frontend Penyedia Load Balancer Gateway.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-LoadBalancerBackendAddressPool

Menentukan kumpulan kumpulan alamat backend load balancer tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:PSBackendAddressPool[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-LoadBalancerBackendAddressPoolId

Menentukan kumpulan kumpulan alamat backend load balancer tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-LoadBalancerInboundNatRule

Menentukan kumpulan referensi aturan terjemahan alamat jaringan masuk (NAT) penyeimbang beban tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:PSInboundNatRule[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-LoadBalancerInboundNatRuleId

Menentukan kumpulan referensi aturan NAT masuk load balancer tempat konfigurasi IP antarmuka jaringan ini berada.

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Menentukan nama konfigurasi IP jaringan yang ditetapkan cmdlet ini.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-NetworkInterface

Menentukan objek NetworkInterface. Cmdlet ini menambahkan konfigurasi IP antarmuka jaringan ke objek yang ditentukan parameter ini.

Jenis:PSNetworkInterface
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Primary

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PrivateIpAddress

Menentukan alamat IP statis konfigurasi IP antarmuka jaringan.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PrivateIpAddressVersion

Menentukan versi alamat IP dari konfigurasi IP antarmuka jaringan. Nilai yang dapat diterima untuk parameter ini adalah:

  • IPv4
  • IPv6
Jenis:String
Nilai yang diterima:IPv4, IPv6
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PublicIpAddress

Menentukan objek PublicIPAddress. Cmdlet ini membuat referensi ke Alamat IP publik untuk dikaitkan dengan konfigurasi IP antarmuka jaringan ini.

Jenis:PSPublicIpAddress
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PublicIpAddressId

Cmdlet ini membuat referensi ke Alamat IP publik untuk dikaitkan dengan konfigurasi IP antarmuka jaringan ini.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Subnet

Menentukan objek Subnet. Cmdlet ini membuat referensi ke subnet tempat konfigurasi IP antarmuka jaringan ini dibuat.

Jenis:PSSubnet
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SubnetId

Cmdlet ini membuat referensi ke subnet tempat konfigurasi IP antarmuka jaringan ini dibuat.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Output

PSNetworkInterface

Catatan

  • Kata kunci: azure, azurerm, arm, sumber daya, manajemen, manajer, jaringan, jaringan