Bagikan melalui

Get-AzPolicyDefinition

  • Referensi
Modul:
Az.Resources

Mendapatkan definisi kebijakan.

Sintaks

Get-AzPolicyDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Deskripsi

Cmdlet Get-AzPolicyDefinition mendapatkan kumpulan definisi kebijakan atau definisi kebijakan tertentu yang diidentifikasi berdasarkan nama atau ID.

Contoh

Contoh 1: Mendapatkan semua definisi kebijakan

Get-AzPolicyDefinition

Perintah ini mendapatkan semua definisi kebijakan.

Contoh 2: Mendapatkan definisi kebijakan dari langganan saat ini menurut nama

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Perintah ini mendapatkan definisi kebijakan bernama VMPolicyDefinition dari langganan default saat ini.

Contoh 3: Mendapatkan definisi kebijakan dari grup manajemen menurut nama

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

Perintah ini mendapatkan definisi kebijakan bernama VMPolicyDefinition dari grup manajemen bernama Dept42.

Contoh 4: Mendapatkan semua definisi kebijakan bawaan dari langganan

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

Perintah ini mendapatkan semua definisi kebijakan bawaan dari langganan dengan ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Contoh 5: Mendapatkan definisi kebijakan dari kategori tertentu

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

Perintah ini mendapatkan semua definisi kebijakan dalam kategori Tag.

Contoh 6: Dapatkan nama tampilan, deskripsi, jenis kebijakan, dan metadata semua definisi kebijakan yang diformat sebagai daftar

Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Perintah ini berguna saat Anda perlu menemukan properti DisplayName yang mudah dibaca pembaca dari definisi Azure Policy. Anda dapat mengurai properti Metadata untuk menemukan nomor versi dan penetapan kategori definisi kebijakan.

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

-Builtin

Membatasi daftar hasil hanya untuk definisi kebijakan bawaan.

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

-Custom

Membatasi daftar hasil hanya untuk definisi kebijakan kustom.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:True
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 definisi kebijakan yang didapat cmdlet ini.

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

-ManagementGroupName

Nama grup manajemen definisi kebijakan yang akan didapatkan.

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

-Name

Menentukan nama definisi 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

-SubscriptionId

ID langganan definisi kebijakan yang akan didapatkan.

Jenis:Nullable<T>[Guid]
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

Input

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Output

PSObject