Get-AzPolicyState
Kaynaklar için ilke uyumluluk durumlarını alır.
Syntax
Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
-ManagementGroupName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
-ResourceGroupName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
-ResourceId <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-Expand <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
-PolicySetDefinitionName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
-PolicyDefinitionName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
-PolicyAssignmentName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyState
[-All]
[-SubscriptionId <String>]
-ResourceGroupName <String>
-PolicyAssignmentName <String>
[-Top <Int32>]
[-OrderBy <String>]
[-Select <String>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-Apply <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Kaynaklar için ilke uyumluluk durumlarını alır. İlke durumu kayıtları çeşitli kapsamlarda sorgulanabilir. Belirtilen zaman aralığına (varsayılan olarak son güne) bağlı olarak, en son ilke durumları veya tüm ilke durumu geçişleri sorgulanabilir. Sonuçlar filtrelenebilir, gruplandırılabilir ve grup toplamaları hesaplanabilir.
Örnekler
Örnek 1: Geçerli abonelik kapsamındaki en son ilke durumlarını alma
Get-AzPolicyStateGeçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 2: Belirtilen abonelik kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5"Belirtilen abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 3: Geçerli abonelik kapsamındaki tüm ilke durumlarını alma
Get-AzPolicyState -AllGeçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan tüm geçmiş ilke durumu kayıtlarını (en son dahil) alır.
Örnek 4: Yönetim grubu kapsamında en son ilke durumlarını alma
Get-AzPolicyState -ManagementGroupName "myManagementGroup"Belirtilen yönetim grubu içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 5: Geçerli abonelikteki kaynak grubu kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -ResourceGroupName "myResourceGroup"Belirtilen kaynak grubu içindeki tüm kaynaklar için (geçerli oturum bağlamındaki abonelikte) son gün oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 6: Belirtilen abonelikteki kaynak grubu kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -ResourceGroupName "myResourceGroup"Belirtilen kaynak grubundaki (belirtilen abonelikte) tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 7: Bir kaynak için en son ilke durumlarını alma
Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"Belirtilen kaynak için son gün içinde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 8: Geçerli abonelikte ilke kümesi tanımı için en son ilke durumlarını alma
Get-AzPolicyState -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Belirtilen ilke kümesi tanımından (geçerli oturum bağlamında abonelikte var olan) etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 9: Belirtilen abonelikteki bir ilke kümesi tanımı için en son ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Belirtilen ilke kümesi tanımı (belirtilen abonelikte var olan) tarafından etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 10: Geçerli abonelikteki bir ilke tanımı için en son ilke durumlarını alma
Get-AzPolicyState -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Belirtilen ilke tanımından (geçerli oturum bağlamında abonelikte var olan) etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son gün oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 11: Belirtilen abonelikteki bir ilke tanımı için en son ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Belirtilen ilke tanımından (belirtilen abonelikte var olan) etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 12: Geçerli abonelikteki bir ilke ataması için en son ilke durumlarını alma
Get-AzPolicyState -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Belirtilen ilke ataması (geçerli oturum bağlamında abonelik kapsamında var) tarafından etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son günde oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 13: Belirtilen abonelikle aynı kapsama sahip bir ilke ataması için en son ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Belirtilen ilke atamasının (belirtilen abonelikteki abonelik kapsamında var olan) etkilediği tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son gün oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 14: Geçerli abonelikte belirtilen kaynak grubunda ilke ataması için en son ilke durumlarını alma
Get-AzPolicyState -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Belirtilen ilke ataması (geçerli oturum bağlamında abonelikteki kaynak grubunda var olan) tarafından etkilenen tüm kaynaklar (geçerli oturum bağlamındaki kiracı içinde) için son gün oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 15: OrderBy, Top ve Select sorgu seçenekleriyle geçerli abonelik kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -OrderBy "Timestamp desc, PolicyAssignmentName asc" -Top 5 -Select "Timestamp, ResourceId, PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionId, IsCompliant"Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır. Komutu sonuçları zaman damgası ve ilke ataması adı özelliklerine göre sıralar ve bu sırada listelenenlerden yalnızca ilk 5'ini alır. Ayrıca, her kayıt için sütunların yalnızca bir alt kümesini listelemeyi seçer.
Örnek 16: Başlangıç ve Son sorgu seçenekleriyle geçerli abonelik kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -From "2018-03-08 00:00:00Z" -To "2018-03-15 00:00:00Z"Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için belirtilen tarih aralığında oluşturulan en son ilke durumu kayıtlarını alır.
Örnek 17: Filtre sorgusu seçeneğiyle geçerli abonelik kapsamındaki en son ilke durumlarını alma
Get-AzPolicyState -Filter "(PolicyDefinitionAction eq 'deny' or PolicyDefinitionAction eq 'audit') and ComplianceState eq 'NonCompliant' and ResourceLocation ne 'eastus'"Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır. Komutu, ilke tanımı eylemine (reddetme veya denetim eylemlerini içerir), uyumluluk durumuna (yalnızca uyumlu olmayan durumu içerir) ve kaynak konumuna (eastus konumunu hariç tutar) göre filtreleyerek döndürülen sonuçları sınırlar.
Örnek 18: Geçerli abonelik kapsamındaki en son ilke durumlarını alma ve Uygula'nın satır sayısı toplamasını belirtmesi
Get-AzPolicyState -Apply "aggregate(`$count as NumberOfRecords)"Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarının sayısını alır. Komutu yalnızca additionalProperties özelliği içinde döndürülen ilke durumu kayıtlarının sayısını döndürür.
Örnek 19: Geçerli abonelik kapsamındaki en son ilke durumlarını alma, Uygula ile toplama ile gruplandırma belirtme
Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId), aggregate(`$count as NumStates))" -OrderBy "NumStates desc" -Top 5Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır. komutu, uyumluluk durumuna göre filtreleyerek döndürülen sonuçları sınırlar (yalnızca uyumlu olmayan durumu içerir). İlke ataması, ilke kümesi tanımı ve ilke tanımına göre sonuçları gruplandırıyor ve her gruptaki kayıt sayısını hesaplayarak AdditionalProperties özelliğinin içinde döndürülür. Sonuçları azalan düzende sayı toplamaya göre sıralar ve bu sırada listelenenlerden yalnızca ilk 5'ini alır.
Örnek 20: Geçerli abonelik kapsamındaki en son ilke durumlarını alma ve Toplama olmadan gruplandırma belirtmeyi uygula ile alma
Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((ResourceId))"Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır. komutu, uyumluluk durumuna göre filtreleyerek döndürülen sonuçları sınırlar (yalnızca uyumlu olmayan durumu içerir). Sonuçları kaynak kimliğine göre gruplandırmaktadır. Bu, abonelik içindeki en az bir ilke için uyumlu olmayan tüm kaynakların listesini oluşturur.
Örnek 21: Geçerli abonelik kapsamındaki en son ilke durumlarını alma ve Uygula'nın birden çok gruplandırma belirtmesi
Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId, ResourceId))/groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId), aggregate(`$count as NumNonCompliantResources))" -OrderBy "NumNonCompliantResources desc" -Top 5Geçerli oturum bağlamında abonelik içindeki tüm kaynaklar için son günde oluşturulan en son ilke durumu kayıtlarını alır. komutu, uyumluluk durumuna göre filtreleyerek döndürülen sonuçları sınırlar (yalnızca uyumlu olmayan durumu içerir). İlk olarak sonuçları ilke ataması, ilke kümesi tanımı, ilke tanımı ve kaynak kimliğine göre gruplandırmaktadır. Ardından, bu gruplandırma sonuçlarını kaynak kimliği dışında aynı özelliklerle gruplandırarak AdditionalProperties özelliği içinde döndürülen bu grupların her birinde kayıt sayısını hesaplar. Sonuçları azalan düzende sayı toplamaya göre sıralar ve bu sırada listelenenlerden yalnızca ilk 5'ini alır. Bu, en fazla uyumlu olmayan kaynak sayısına sahip ilk 5 ilkeyi oluşturur.
Örnek 22: Bir kaynağın ilke değerlendirme ayrıntıları da dahil olmak üzere en son ilke durumlarını alma
Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1" -Expand "PolicyEvaluationDetails"Belirtilen kaynak için son gün içinde oluşturulan en son ilke durumu kayıtlarını alır ve policyEvaluationDetails'i genişletin.
Örnek 23: Kaynak sağlayıcısı modu ilke ataması verilen bir kaynak (örn. kasa) için en son bileşen ilkesi durumlarını alma
Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"Kaynak sağlayıcısı modu ilke tanımına başvuran bir kaynak sağlayıcısı modu ilke ataması verilip belirtilen kaynak için son gün oluşturulan en son bileşen ilkesi durum kayıtlarını alır.
Örnek 24: Kaynak sağlayıcısı modu ilke tanımını içeren bir ilke girişimi ataması verilen bir kaynak (örn. kasa) için en son bileşen ilkesi durumlarını alma
Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1' and policyDefinitionReferenceId eq 'myResourceProviderModeDefinitionReferenceId'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"Kaynak sağlayıcısı modu ilke tanımı içeren bir girişime başvuran bir kaynak sağlayıcısı modu ilke ataması verilip belirtilen kaynak için son gün oluşturulan en son bileşen ilkesi durum kayıtlarını alır.
Örnek 25: Kaynak sağlayıcısı modu ilke ataması verilen bir kaynağın (örn. kasa) uyumluluk durumuna göre en son bileşen sayılarını alma
Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant' or ComplianceState eq 'Conflict';`$apply=groupby((complianceState),aggregate(`$count as count)))"Kaynak sağlayıcısı modu ilke ataması verildiğinde, son günde oluşturulan en son bileşen sayısını belirtilen kaynak için uyumluluk durumuna göre gruplandırılmış olarak alır.
Örnek 26: Yönetim grubu kapsam ilkesi ataması için ilke durumlarını alma
Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -Filter "policyAssignmentId eq '/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'"Belirtilen ilke atamasının (belirtilen aboneliğin üst öğesi olan bir yönetim grubuna atanır) etkilenen belirtilen abonelikteki tüm kaynaklar (geçerli oturum bağlamında kiracı içinde) için son gün oluşturulan en son ilke durumu kayıtlarını alır.
Parametreler
-All
Belirtilen zaman aralığında, yalnızca en son durum yerine tüm ilke durumlarını alın.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Apply
OData gösterimini kullanarak toplamalar için ifade uygulama.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Azure ile iletişim için kullanılan kimlik bilgileri, hesap, kiracı ve abonelik.
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Expand
OData gösterimini kullanarak ifadeyi genişletin.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
OData gösterimini kullanarak ifadeyi filtreleyin.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-From
Sorgulanma aralığının başlangıç zamanını belirten ISO 8601 biçimli zaman damgası. Belirtilmediğinde varsayılan olarak 'To' parametre değeri eksi 1 gün olur.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementGroupName
Yönetim grubu adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-OrderBy
OData gösterimini kullanarak ifade sıralama. İsteğe bağlı 'desc' (varsayılan) veya 'asc' ile virgülle ayrılmış bir veya daha fazla sütun adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PolicyAssignmentName
İlke atamasının adı.
Bu ilke ataması, parametre kümesiyle tam olarak aynı kapsama sahip olmalıdır. Bu bir yönetim grubu kapsam ilkesi ataması olamaz.
Örneğin: ve ResourceGroupName belirtilirse-SubscriptionId, ilke ataması bu kaynak grubuna atanmalıdır. Yalnızca -SubscriptionId belirtilirse, ilke ataması bu aboneliğe atanmalıdır.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyDefinitionName
İlke tanımının adı. Sorgulanan abonelikte bu ilke tanımı bulunmalıdır. Bu bir yönetim grubu kapsam ilkesi tanımı olamaz.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicySetDefinitionName
İlke kümesi tanımının adı. Sorgulanan abonelikte bu ilke kümesi tanımı bulunmalıdır. Bu bir yönetim grubu kapsam ilkesi kümesi tanımı olamaz.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Kaynak grubu adı.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
Kaynak Kimliği.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Select
OData gösterimini kullanarak ifadeyi seçin. Bir veya daha fazla virgülle ayrılmış sütun adı. Her kayıt üzerindeki sütunları yalnızca istenenlerle sınırlar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
Abonelik kimliği.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-To
Sorgu için aralığın bitiş saatini belirten ISO 8601 biçimli zaman damgası. Belirtilmediğinde, varsayılan olarak istek zamanına göre belirlenir.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Top
Döndürülecek en fazla kayıt sayısı.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |