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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Builtin

Membatasi daftar hasil hanya untuk definisi kebijakan bawaan.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Custom

Membatasi daftar hasil hanya untuk definisi kebijakan kustom.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

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

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Nama grup manajemen definisi kebijakan yang akan didapatkan.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Menentukan nama definisi kebijakan yang didapat cmdlet ini.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

ID langganan definisi kebijakan yang akan didapatkan.

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

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

Output

PSObject