Set-AzNetworkInterfaceIpConfig

Modul:

Az.Network Module

Memperbarui konfigurasi IP untuk antarmuka jaringan.

Sintaks

SetByResource (Default)

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

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

Properti parameter

Jenis:	PSApplicationGatewayBackendAddressPool[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ApplicationGatewayBackendAddressPoolId

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ApplicationSecurityGroup

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

Properti parameter

Jenis:	PSApplicationSecurityGroup[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ApplicationSecurityGroupId

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-DefaultProfile

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

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-GatewayLoadBalancerId

Menentukan ID Konfigurasi Ip Frontend Penyedia Load Balancer Gateway.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LoadBalancerBackendAddressPool

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

Properti parameter

Jenis:	PSBackendAddressPool[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LoadBalancerBackendAddressPoolId

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LoadBalancerInboundNatRule

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

Properti parameter

Jenis:	PSInboundNatRule[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-LoadBalancerInboundNatRuleId

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

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-Name

Menentukan nama konfigurasi IP jaringan yang ditetapkan cmdlet ini.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-NetworkInterface

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

Properti parameter

Jenis:	PSNetworkInterface
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Primary

Cmdlet Set-AzNetworkInterfaceIpConfig memperbarui konfigurasi IP untuk antarmuka jaringan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PrivateIpAddress

Menentukan alamat IP statis konfigurasi IP antarmuka jaringan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PrivateIpAddressVersion

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

• IPv4
• IPv6

Properti parameter

Jenis:	String
Nilai default:	None
Nilai yang diterima:	IPv4, IPv6
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PublicIpAddress

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

Properti parameter

Jenis:	PSPublicIpAddress
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-PublicIpAddressId

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Subnet

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

Properti parameter

Jenis:	PSSubnet
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResource

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-SubnetId

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

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

SetByResourceId

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSNetworkInterface

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Output

PSNetworkInterface

Catatan

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

Link Terkait

• Add-AzNetworkInterfaceIpConfig
• Get-AzNetworkInterfaceIpConfig
• New-AzNetworkInterfaceIpConfig
• Remove-AzNetworkInterfaceIpConfig