Get-AzPolicyDefinition

  • Başvuru
Modül:
Az.Resources

İlke kümesi tanımlarını alır.

Sözdizimi

Get-AzPolicyDefinition
   [-Name <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Static]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

Get-AzPolicyDefinition cmdlet'i bir ilke kümesi tanımları koleksiyonunu veya ad veya kimlikle tanımlanan belirli bir ilke kümesi tanımını alır.

Örnekler

Örnek 1: Tüm ilke tanımlarını alma

Get-AzPolicyDefinition

Bu komut tüm ilke tanımlarını alır.

Örnek 2: Geçerli abonelikten ada göre ilke tanımı alma

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Bu komut, geçerli varsayılan abonelikten VMPolicyDefinition adlı ilke tanımını alır.

Örnek 3: Yönetim grubundan ada göre ilke tanımını alma

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

Bu komut, Dept42 adlı yönetim grubundan VMPolicyDefinition adlı ilke tanımını alır.

Örnek 4: Abonelikten tüm yerleşik ilke tanımlarını alma

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

Bu komut, 3bf44b72-c631-427a-b8c8-53e2595398ca kimliğine sahip abonelikten tüm yerleşik ilke tanımlarını alır.

Örnek 5: Belirli bir kategoriden ilke tanımlarını alma

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

Bu komut Etiketler kategorisindeki tüm ilke tanımlarını alır.

Örnek 6: Liste olarak biçimlendirilmiş tüm ilke tanımlarının görünen adını, açıklamasını, ilke türünü ve meta verilerini alma

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

Bu komut, Azure İlkesi tanımının okuyucu dostu DisplayName özelliğini bulmanız gerektiğinde kullanışlıdır. İlke tanımının sürüm numarasını ve kategori atamasını bulmak için Metadata özelliğini ayrıştırabilirsiniz.

Örnek 7: [Backcompat] Liste olarak biçimlendirilmiş tüm ilke tanımlarının görünen adını, açıklamasını, ilke türünü ve meta verilerini alma

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

Bu komut, Azure İlkesi tanımının okuyucu dostu DisplayName özelliğini bulmanız gerektiğinde kullanışlıdır. İlke tanımının sürüm numarasını ve kategori atamasını bulmak için Metadata özelliğini ayrıştırabilirsiniz.

Parametreler

-BackwardCompatible

Cmdlet'in bir özellik paketi nesnesine ilkeye özgü özellikler yerleştirerek eski biçimi kullanarak yapıtlar döndürmesine neden olur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Builtin

Cmdlet'in yalnızca yerleşik ilke tanımlarını döndürmesine neden olur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Custom

Cmdlet'in yalnızca özel ilke tanımları döndürmesine neden olur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-DefaultProfile

Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.

Tür:PSObject
Diğer adlar:AzureRMContext, AzureCredential
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Id

Alınacak ilke tanımının tam kimliği.

Tür:String
Diğer adlar:ResourceId
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ListVersion

Cmdlet'in yalnızca özel ilke tanımları döndürmesine neden olur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ManagementGroupName

Yönetim grubunun adı.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Alınacak ilke tanımının adı.

Tür:String
Diğer adlar:PolicyDefinitionName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Static

Cmdlet'in yalnızca statik ilke tanımları döndürmesine neden olur.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-SubscriptionId

Hedef aboneliğin kimliği.

Tür:String
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Version

#.#.# biçimindeki ilke tanımı sürümü.

Tür:String
Diğer adlar:PolicyDefinitionVersion
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

SwitchParameter

String

Çıkışlar

IPolicyDefinition