Bagikan melalui

Get-AzPolicyAssignment

  • Referensi
Modul:
Az.Resources

Mendapatkan penetapan kebijakan.

Sintaks

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzPolicyAssignment mendapatkan semua penetapan kebijakan atau penugasan tertentu. Identifikasi penetapan kebijakan untuk mendapatkan berdasarkan nama dan cakupan atau menurut ID.

Contoh

Contoh 1: Mendapatkan semua penetapan kebijakan

Get-AzPolicyAssignment

Perintah ini mendapatkan semua penetapan kebijakan.

Contoh 2: Mendapatkan penetapan kebijakan tertentu

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

Perintah pertama mendapatkan grup sumber daya bernama ResourceGroup11 dengan menggunakan cmdlet Get-AzResourceGroup dan menyimpannya dalam variabel $ResourceGroup. Perintah kedua mendapatkan penetapan kebijakan bernama PolicyAssignment07 untuk cakupan yang diidentifikasi properti ResourceId dari $ResourceGroup.

Contoh 3: Mendapatkan semua penetapan kebijakan yang ditetapkan ke grup manajemen

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

Perintah pertama menentukan ID grup manajemen yang akan dikueri. Perintah kedua mendapatkan semua penetapan kebijakan yang ditetapkan ke grup manajemen dengan ID 'myManagementGroup'.

Contoh 4: Dapatkan cakupan, pengidentifikasi definisi kumpulan kebijakan, dan nama tampilan semua penetapan kebijakan yang diformat sebagai daftar

Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Perintah ini berguna saat Anda perlu menemukan properti DisplayName yang mudah dibaca pembaca dari penetapan Azure Policy.

Parameter

-ApiVersion

Menentukan versi API penyedia sumber daya yang akan digunakan. Jika Anda tidak menentukan versi, cmdlet ini menggunakan versi terbaru yang tersedia.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
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

-Id

Menentukan ID sumber daya yang sepenuhnya memenuhi syarat untuk penetapan kebijakan yang didapat cmdlet ini.

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

-IncludeDescendent

Menyebabkan daftar penetapan kebijakan yang dikembalikan menyertakan semua tugas yang terkait dengan cakupan yang diberikan, termasuk yang berasal dari cakupan leluhur dan yang berasal dari cakupan keturunan.

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

-Name

Menentukan nama penetapan kebijakan yang didapat cmdlet ini.

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

-PolicyDefinitionId

Menentukan ID definisi kebijakan dari penetapan kebijakan yang didapat cmdlet ini.

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

-Pre

Menunjukkan bahwa cmdlet ini mempertimbangkan versi API pra-rilis ketika secara otomatis menentukan versi mana yang akan digunakan.

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

-Scope

Menentukan cakupan di mana kebijakan diterapkan untuk penugasan yang didapat cmdlet ini.

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

Input

String

SwitchParameter

Output

PsPolicyAssignment