Bagikan melalui

Set-AzureRmNetworkInterfaceIpConfig

  • Referensi
Modul:
AzureRM.Network

Mengatur status tujuan untuk konfigurasi IP antarmuka jaringan Azure.

Peringatan

Modul AzureRM PowerShell telah resmi tidak digunakan lagi per 29 Februari 2024. Pengguna disarankan untuk bermigrasi dari AzureRM ke modul Az PowerShell untuk memastikan dukungan dan pembaruan yang berkelanjutan.

Meskipun modul AzureRM mungkin masih berfungsi, modul tersebut tidak lagi dipertahankan atau didukung, menempatkan penggunaan berkelanjutan berdasarkan kebijaksanaan dan risiko pengguna. Silakan merujuk ke sumber daya migrasi kami untuk panduan tentang transisi ke modul Az.

Sintaks

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

Deskripsi

Cmdlet Set-AzureRmNetworkInterfaceIpConfig menetapkan status tujuan untuk konfigurasi IP antarmuka jaringan Azure.

Contoh

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

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.

2: Mengaitkan konfigurasi IP dengan grup keamanan aplikasi

$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

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

Parameter

-ApplicationGatewayBackendAddressPool

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

Jenis:List<T>[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:List<T>[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:List<T>[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:List<T>[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:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-LoadBalancerBackendAddressPool

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

Jenis:List<T>[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:List<T>[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:List<T>[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:List<T>[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

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

Output

PSNetworkInterface

Catatan

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