az policy state

  • Başvuru

İlke uyumluluk durumlarını yönetme.

Komutlar

Name Description Tür Durum
az policy state list

İlke uyumluluk durumlarını listeleyin.

 Temel GA
az policy state summarize

İlke uyumluluk durumlarını özetleyin.

 Temel GA
az policy state trigger-scan

Kapsam için ilke uyumluluğu değerlendirmesi tetikleme.

 Temel GA

az policy state list

Düzenle

İlke uyumluluk durumlarını listeleyin.

az policy state list [--all]
                     [--apply]
                     [--expand]
                     [--filter]
                     [--from]
                     [--management-group]
                     [--namespace]
                     [--order-by]
                     [--parent]
                     [--policy-assignment]
                     [--policy-definition]
                     [--policy-set-definition]
                     [--resource]
                     [--resource-group]
                     [--resource-type]
                     [--select]
                     [--to]
                     [--top]

Örnekler

Geçerli abonelik kapsamındaki en son ilke durumlarını alın.

az policy state list

Geçerli abonelik kapsamındaki tüm ilke durumlarını alın.

az policy state list --all

Yönetim grubu kapsamında en son ilke durumlarını alın.

az policy state list -m "myMg"

Geçerli abonelikteki kaynak grubu kapsamında en son ilke durumlarını alın.

az policy state list -g "myRg"

Kaynak kimliğini kullanarak bir kaynak için en son ilke durumlarını alın.

az policy state list --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup /providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"

Kaynak adını kullanarak bir kaynağın en son ilke durumlarını alın.

az policy state list --resource "myKeyVault" --namespace "Microsoft.KeyVault" --resource-type "vaults" -g "myresourcegroup"

Kaynak adını kullanarak iç içe yerleştirilmiş bir kaynak için en son ilke durumlarını alın.

az policy state list --resource "myRule1" --namespace "Microsoft.Network" --resource-type "securityRules" --parent "networkSecurityGroups/mysecuritygroup1" -g "myresourcegroup"

Geçerli abonelikteki bir ilke kümesi tanımı için en son ilke durumlarını alın.

az policy state list -s "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Geçerli abonelikteki bir ilke tanımı için en son ilke durumlarını alın.

az policy state list -d "fff69973-fff8-fff5-fffc-fffbe7c9d698"

Geçerli abonelikteki bir ilke ataması için en son ilke durumlarını alın.

az policy state list -a "ddd8ef92e3714a5ea3d208c1"

Geçerli abonelikte belirtilen kaynak grubundaki bir ilke ataması için en son ilke durumlarını alın.

az policy state list -g "myRg" -a "ddd8ef92e3714a5ea3d208c1"

Özelliklerin bir alt kümesini seçerek ve sıralamayı özelleştirerek geçerli abonelikteki en son 5 ilke durumunu alın.

az policy state list --top 5 --order-by "timestamp desc, policyAssignmentName asc" --select "timestamp, resourceId, policyAssignmentId, policySetDefinitionId, policyDefinitionId"

Özel bir zaman aralığı boyunca geçerli abonelikteki en son ilke durumlarını alın.

az policy state list --from "2018-03-08T00:00:00Z" --to "2018-03-15T00:00:00Z"

Bazı özellik değerlerine göre geçerli abonelik filtreleme sonuçlarında en son ilke durumlarını alın.

az policy state list --filter "(policyDefinitionAction eq 'deny' or policyDefinitionAction eq 'audit') and resourceLocation ne 'eastus'"

Geçerli abonelikteki en son ilke durumlarının sayısını alın.

az policy state list --apply "aggregate($count as numberOfRecords)"

Bazı özelliklere göre sonuçları toplayarak geçerli abonelikteki en son ilke durumlarını alın.

az policy state list --apply "groupby((policyAssignmentId, policySetDefinitionId, policyDefinitionReferenceId, policyDefinitionId), aggregate($count as numStates))"

Bazı özelliklere göre geçerli abonelik gruplandırma sonuçlarında en son ilke durumlarını alın.

az policy state list --apply "groupby((policyAssignmentName, resourceId))"

Birden çok gruplandırma belirten bazı özelliklere göre sonuçları toplayan geçerli abonelikte en son ilke durumlarını alın.

az policy state list --apply "groupby((policyAssignmentId, policySetDefinitionId, policyDefinitionReferenceId, policyDefinitionId, resourceId))/groupby((policyAssignmentId, policySetDefinitionId, policyDefinitionReferenceId, policyDefinitionId), aggregate($count as numNonCompliantResources))"

İlke değerlendirme ayrıntıları da dahil olmak üzere bir kaynak için en son ilke durumlarını alın.

az policy state list --resource "myKeyVault" --namespace "Microsoft.KeyVault" --resource-type "vaults" -g "myresourcegroup" --expand PolicyEvaluationDetails

Kaynak sağlayıcısı modu ilke tanımına başvuran bir kaynak (örn. kasa) ve ilke ataması için en son bileşen ilkesi durumlarını alma

az policy state list --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myKeyVault" --filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa'" --expand "Components($filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"

Kaynak sağlayıcısı modu ilke tanımını içeren bir girişime başvuran bir kaynak (örn. kasa) ve ilke ataması için en son bileşen ilkesi durumlarını alma

az policy state list --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myKeyVault" --filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa' and policyDefinitionReferenceId eq 'myResourceProviderModeDefinitionReferenceId'" --expand "Components($filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"

Kaynak sağlayıcısı modu ilke tanımına başvuran bir kaynak (örn. kasa) ve ilke ataması için uyumluluk durumuna göre en son bileşen sayılarını alma

az policy state list --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myKeyVault" --filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa'" --expand "Components($filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant' or ComplianceState eq 'Conflict';$apply=groupby((complianceState),aggregate($count as count)))"

İsteğe Bağlı Parametreler

--all

Belirtilen zaman aralığında, yalnızca en son durum yerine tüm ilke durumlarını alın.

varsayılan değer: False
--apply

OData gösterimini kullanarak toplamalar için ifade uygulama.

--expand

OData gösterimini kullanarak ifadeyi genişletin.

--filter

OData gösterimini kullanarak ifadeyi filtreleyin.

--from

Sorgulanma aralığının başlangıç zamanını belirten ISO 8601 biçimli zaman damgası.

--management-group -m

Yönetim grubunun adı.

--namespace

Sağlayıcı ad alanı (Ör. Microsoft.Provider).

--order-by

OData gösterimini kullanarak ifade sıralama.

--parent

Üst yol (Ör. resourceTypeA/nameA/resourceTypeB/nameB).

--policy-assignment -a

İlke atamasının adı.

--policy-definition -d

İlke tanımının adı.

--policy-set-definition -s

İlke kümesi tanımının adı.

--resource

Kaynak kimliği veya kaynak adı. Bir ad verilirse, lütfen kaynak grubunu ve diğer ilgili kaynak kimliği bağımsız değişkenlerini belirtin.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--resource-type

Kaynak türü (Örn: resourceTypeC).

--select

OData gösterimini kullanarak ifadeyi seçin.

--to

Sorgu için aralığın bitiş saatini belirten ISO 8601 biçimli zaman damgası.

--top

Döndürülecek en fazla kayıt sayısı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az policy state summarize

Düzenle

İlke uyumluluk durumlarını özetleyin.

az policy state summarize [--filter]
                          [--from]
                          [--management-group]
                          [--namespace]
                          [--parent]
                          [--policy-assignment]
                          [--policy-definition]
                          [--policy-set-definition]
                          [--resource]
                          [--resource-group]
                          [--resource-type]
                          [--to]
                          [--top]

Örnekler

Geçerli abonelik kapsamında en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize

Yönetim grubu kapsamında en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -m "myMg"

Geçerli abonelikteki kaynak grubu kapsamında en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -g "myRg"

Kaynak kimliğini kullanarak bir kaynak için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup /providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"

Kaynak adını kullanarak bir kaynağın en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize --resource "myKeyVault" --namespace "Microsoft.KeyVault" --resource-type "vaults" -g "myresourcegroup"

Kaynak adını kullanarak iç içe bir kaynak için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize --resource "myRule1" --namespace "Microsoft.Network" --resource-type "securityRules" --parent "networkSecurityGroups/mysecuritygroup1" -g "myresourcegroup"

Geçerli abonelikteki ilke kümesi tanımı için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -s "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Geçerli abonelikteki bir ilke tanımı için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -d "fff69973-fff8-fff5-fffc-fffbe7c9d698"

Geçerli abonelikteki bir ilke ataması için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -a "ddd8ef92e3714a5ea3d208c1"

Geçerli abonelikte belirtilen kaynak grubundaki bir ilke ataması için en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize -g "myRg" -a "ddd8ef92e3714a5ea3d208c1"

Atama özetini ilk 5 ile sınırlayarak geçerli abonelikte en son uyumlu olmayan ilke durumları özetini alın.

az policy state summarize --top 5

Özel bir zaman aralığı için geçerli abonelikteki en son uyumlu olmayan ilke durumlarının özetini alın.

az policy state summarize --from "2018-03-08T00:00:00Z" --to "2018-03-15T00:00:00Z"

Bazı özellik değerlerine göre geçerli abonelik filtreleme sonuçlarında en son uyumlu olmayan ilke durumları özetini alın.

az policy state summarize --filter "(policyDefinitionAction eq 'deny' or policyDefinitionAction eq 'audit') and resourceLocation ne 'eastus'"

İsteğe Bağlı Parametreler

--filter

OData gösterimini kullanarak ifadeyi filtreleyin.

--from

Sorgulanma aralığının başlangıç zamanını belirten ISO 8601 biçimli zaman damgası.

--management-group -m

Yönetim grubunun adı.

--namespace

Sağlayıcı ad alanı (Ör. Microsoft.Provider).

--parent

Üst yol (Ör. resourceTypeA/nameA/resourceTypeB/nameB).

--policy-assignment -a

İlke atamasının adı.

--policy-definition -d

İlke tanımının adı.

--policy-set-definition -s

İlke kümesi tanımının adı.

--resource

Kaynak kimliği veya kaynak adı. Bir ad verilirse, lütfen kaynak grubunu ve diğer ilgili kaynak kimliği bağımsız değişkenlerini belirtin.

--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

--resource-type

Kaynak türü (Örn: resourceTypeC).

--to

Sorgu için aralığın bitiş saatini belirten ISO 8601 biçimli zaman damgası.

--top

Döndürülecek en fazla kayıt sayısı.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.

az policy state trigger-scan

Düzenle

Kapsam için ilke uyumluluğu değerlendirmesi tetikleme.

az policy state trigger-scan [--no-wait]
                             [--resource-group]

Örnekler

Geçerli abonelik kapsamında bir ilke uyumluluğu değerlendirmesi tetikleme.

az policy state trigger-scan

Kaynak grubu için ilke uyumluluğu değerlendirmesi tetikleme.

az policy state trigger-scan -g "myRg"

Kaynak grubu için bir ilke uyumluluk değerlendirmesi tetikler ve tamamlanmasını beklemeyin.

az policy state trigger-scan -g "myRg" --no-wait

İsteğe Bağlı Parametreler

--no-wait

Uzun süre çalışan işlemin bitmesini beklemeyin.

varsayılan değer: False
--resource-group -g

Kaynak grubunun adı. kullanarak varsayılan grubu az configure --defaults group=<name>yapılandırabilirsiniz.

Global Parametreler
--debug

Tüm hata ayıklama günlüklerini göstermek için günlük ayrıntı düzeyini artırın.

--help -h

Bu yardım iletisini göster ve çık.

--only-show-errors

Yalnızca hataları gösterir ve uyarıları gizler.

--output -o

Çıkış biçimi.

kabul edilen değerler: json, jsonc, none, table, tsv, yaml, yamlc
varsayılan değer: json
--query

JMESPath sorgu dizesi. Daha fazla bilgi ve örnek için bkz http://jmespath.org/ .

--subscription

Aboneliğin adı veya kimliği. kullanarak az account set -s NAME_OR_IDvarsayılan aboneliği yapılandırabilirsiniz.

--verbose

Günlük ayrıntı düzeyini artırın. Tam hata ayıklama günlükleri için --debug komutunu kullanın.