Bagikan melalui

Set-AzureAclConfig

  • Referensi
Modul:
Azure

Memodifikasi objek konfigurasi ACL.

Catatan

Cmdlet yang dirujuk dalam dokumentasi ini adalah untuk mengelola sumber daya Azure warisan yang menggunakan API Azure Service Manager (ASM). Modul PowerShell warisan ini tidak disarankan saat membuat sumber daya baru karena ASM dijadwalkan untuk dihentikan. Untuk informasi selengkapnya, lihat Penghentian Azure Service Manager.

Modul Az PowerShell adalah modul PowerShell yang direkomendasikan untuk mengelola sumber daya Azure Resource Manager (ARM) dengan PowerShell.

Sintaks

Set-AzureAclConfig
   [-AddRule]
   [-Action] <String>
   [-RemoteSubnet] <String>
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-RemoveRule]
   [-RuleId] <Int32>
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureAclConfig
   [-SetRule]
   [-RuleId] <Int32>
   [[-Action] <String>]
   [[-RemoteSubnet] <String>]
   [[-Order] <Int32>]
   [[-Description] <String>]
   -ACL <NetworkAclObject>
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Deskripsi

Cmdlet Set-AzureAclConfig memodifikasi objek konfigurasi daftar kontrol akses (ACL) dari konfigurasi komputer virtual Azure yang ada.

Contoh

Contoh 1: Menambahkan aturan ke konfigurasi ACL baru

PS C:\> $Acl = New-AzureAclConfig
PS C:\> Set-AzureAclConfig -AddRule -ACL $Acl -Action Permit -RemoteSubnet "172.0.0.0/8" -Order 100 -Description "Permit ACL rule"

Perintah pertama membuat konfigurasi ACL, lalu menyimpannya dalam variabel $Acl.

Perintah kedua menambahkan aturan baru ke konfigurasi yang disimpan di $Acl. Perintah menentukan tindakan, subnet, urutan, dan deskripsi untuk aturan.

Contoh 2: Mengubah aturan dalam konfigurasi ACL

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -SetRule -RuleId 0 -ACL $Acl -Order 102 -Description "Web endpoint rule"
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

Perintah pertama mendapatkan komputer virtual bernama VirtualMachine07 dalam layanan bernama ContosoService dengan menggunakan cmdlet Get-AzureVM . Perintah meneruskan objek tersebut ke cmdlet Get-AzureAclConfig dengan menggunakan operator alur. Cmdlet tersebut mendapatkan konfigurasi ACL untuk titik akhir bernama Web. Perintah menyimpan objek konfigurasi ACL dalam variabel $Acl.

Perintah kedua memodifikasi aturan yang memiliki ID 0. Perintah mengubah urutan dan deskripsi aturan.

Perintah akhir mengatur objek konfigurasi ACL untuk komputer virtual tersebut dengan menggunakan cmdlet Set-AzureEndpoint . Perintah ini juga memperbarui komputer virtual tersebut.

Contoh 3: Menghapus aturan dari konfigurasi ACL

PS C:\> $Acl = Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Get-AzureAclConfig -EndpointName "Web"
PS C:\> Set-AzureAclConfig -RemoveRule -ID 0 -ACL $Acl
PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine07" | Set-AzureEndpoint -ACL $Acl -Name "Web" | Update-AzureVM

Perintah pertama menyimpan objek konfigurasi ACL dalam variabel $Acl. Ini sama dengan contoh sebelumnya.

Perintah kedua menghapus aturan yang memiliki ID 0 dari konfigurasi ACL di $Acl.

Perintah akhir mengatur objek konfigurasi ACL untuk komputer virtual dan memperbarui komputer virtual tersebut. Ini sama dengan contoh sebelumnya.

Parameter

-ACL

Menentukan objek konfigurasi ACL yang dimodifikasi cmdlet ini.

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

-Action

Menentukan tindakan untuk aturan yang ditambahkan atau dimodifikasi cmdlet ini. Nilai yang valid adalah: Izinkan dan Tolak.

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

-AddRule

Menunjukkan bahwa cmdlet ini menambahkan aturan ke konfigurasi ACL.

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

-Description

Menentukan deskripsi untuk aturan yang ditambahkan atau dimodifikasi cmdlet ini.

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

-InformationAction

Menentukan bagaimana cmdlet ini merespons peristiwa informasi.

Nilai yang dapat diterima untuk parameter ini adalah:

  • Lanjutkan
  • Abaikan
  • Tanya
  • Lanjutkan Diam-diam
  • Stop
  • Tangguhkan
Jenis:ActionPreference
Alias:infa
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-InformationVariable

Menentukan variabel informasi.

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

-Order

Menentukan urutan pemrosesan untuk aturan yang ditambahkan atau dimodifikasi cmdlet ini.

Jenis:Int32
Position:2
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-RemoteSubnet

Menentukan subnet jarak jauh untuk aturan yang ditambahkan atau dimodifikasi cmdlet ini. Menentukan alamat dalam format Classless Interdomain Routing (CIDR).

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

-RemoveRule

Menunjukkan bahwa cmdlet ini menghapus aturan dari konfigurasi ACL.

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

-RuleId

Menentukan ID aturan yang dihapus atau dimodifikasi cmdlet ini untuk konfigurasi ACL.

Jenis:Int32
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SetRule

Menunjukkan bahwa cmdlet ini memodifikasi aturan dalam konfigurasi ACL.

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