Aracılığıyla paylaş


Get-AzPolicyDefinition

İlke tanımlarını alır.

Sözdizimi

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>]

Description

Get-AzPolicyDefinition cmdlet'i bir ilke tanımları koleksiyonunu veya ad veya kimlikle tanımlanan belirli bir ilke 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 -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

-ApiVersion

Kullanılacak kaynak sağlayıcısı API'sinin sürümünü belirtir. Bir sürüm belirtmezseniz, bu cmdlet kullanılabilir en son sürümü kullanır.

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

-Builtin

Sonuç listesini yalnızca yerleşik ilke tanımlarıyla sınırlar.

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

-Custom

Sonuç listesini yalnızca özel ilke tanımlarıyla sınırlar.

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

-DefaultProfile

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

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

-Id

Bu cmdlet'in aldığı ilke tanımı için tam kaynak kimliğini belirtir.

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

-ManagementGroupName

Alınacak ilke tanımlarının 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

Bu cmdlet'in aldığı ilke tanımının adını belirtir.

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

-Pre

Bu cmdlet'in hangi sürümün kullanılacağını otomatik olarak belirlediğinde yayın öncesi API sürümlerini göz önünde bulundurduğunu gösterir.

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

-SubscriptionId

Alınacak ilke tanımlarının abonelik kimliği.

Tür:Nullable<T>[Guid]
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

Girişler

String

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

Çıkışlar

PSObject