Sdílet prostřednictvím


az policy definition

Správa definic zásad

Definice zásad jsou pravidla, která určují povolené nebo zakázané konfigurace prostředků Azure.

Příkazy

Name Description Typ Stav
az policy definition create

Vytvořte definici zásady

Core GA
az policy definition delete

Odstraňte definici zásady.

Core GA
az policy definition list

Načtěte definice zásad.

Core GA
az policy definition show

Načte definici zásady.

Core GA
az policy definition update

Aktualizujte definici zásady.

Core GA

az policy definition create

Vytvořte definici zásady

Vytvořte definici zásady v daném předplatném nebo skupině pro správu s daným názvem a dalšími vlastnostmi.

az policy definition create --name
                            [--description]
                            [--display-name]
                            [--management-group]
                            [--metadata]
                            [--mode]
                            [--params]
                            [--rule --rules]
                            [--version]

Příklady

Vytvoření zásad úložiště jen pro čtení

az policy definition create --name readOnlyStorage --rules "{ 'if': { 'field': 'type', 'equals': 'Microsoft.Storage/storageAccounts/write' }, 'then': { 'effect': 'deny' } }"

Vytvoření definice zásady s parametry

az policy definition create --name allowedLocations --rules "{ 'if': { 'allOf': [{ 'field': 'location','notIn': '[parameters(\'listOfAllowedLocations\')]' }, { 'field': 'location', 'notEquals': 'global' }, { 'field': 'type', 'notEquals': 'Microsoft.AzureActiveDirectory/b2cDirectories'}] }, 'then': { 'effect': 'deny' } }" --params "{ 'allowedLocations': {'type': 'array', 'metadata': { 'description': 'The list of locations that can be specified when deploying resources', 'strongType': 'location', 'displayName': 'Allowed locations' } } }"

Vytvoření zásady úložiště jen pro čtení, které je možné použít v rámci skupiny pro správu

az policy definition create -n readOnlyStorage --management-group "MyManagementGroup" --rules "{ 'if': { 'field': 'type', 'equals': 'Microsoft.Storage/storageAccounts/write' }, 'then': { 'effect': 'deny' } }"

Vytvoření definice zásady s režimem

az policy definition create --name TagsPolicyDefinition --subscription "MySubscription" --mode Indexed --rules "{ 'if': { 'field': 'tags', 'exists': 'false' }, 'then': { 'effect': 'deny' } }"

Povinné parametry

--name -n

Název definice zásady.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--description

Popis definice zásady

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--display-name

Zobrazovaný název definice zásady.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--management-group

Skupina pro správu.

--metadata

Metadata definice zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--mode -m

Režim definice zásad.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Default value: Indexed
--params -p

Definice parametrů pravidla zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--rule --rules

Pravidlo zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--version

Verze definice zásady.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az policy definition delete

Změna způsobující chybu

Chování se změní v budoucí verzi příkazů prostředků. Vynechání výzvy k potvrzení bude vyžadovat zadání přepínače -y.

Odstraňte definici zásady.

Odstraňte definici zásady v daném předplatném nebo skupině pro správu s daným názvem a dalšími vlastnostmi.

az policy definition delete --name
                            [--management-group]

Příklady

Odstranění definice zásady

az policy definition delete --name MyPolicyDefinition

Povinné parametry

--name -n

Název definice zásady.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--management-group

Skupina pro správu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az policy definition list

Načtěte definice zásad.

Načtěte seznam všech definic zásad v daném předplatném nebo skupině pro správu.

az policy definition list [--filter]
                          [--management-group]
                          [--max-items]
                          [--next-token]

Příklady

Výpis předdefinovaných definic zásad

az policy definition list --filter atScopeAndBelow()

Výpis definic zásad podle skupiny pro správu

az policy definition list --management-group MyManagementGroup

Výpis definic zásad podle předplatného

az policy definition list

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--filter

Filtrování výsledků seznamu

--management-group

Skupina pro správu.

--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Pokud chcete pokračovat ve stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

Vlastnost Hodnota
Skupina parametrů: Pagination Arguments
--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

Vlastnost Hodnota
Skupina parametrů: Pagination Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az policy definition show

Načte definici zásady.

Načtěte a zobrazte podrobnosti definice zásady v daném předplatném nebo skupině pro správu s daným názvem.

az policy definition show --name
                          [--management-group]

Příklady

Načtení definice zásad na úrovni skupiny pro správu

az policy definition show --management-group MyManagementGroup --name ResourceNaming

Načtení definice zásady

az policy definition show --name ResourceNaming

Povinné parametry

--name -n

Název definice zásady.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--management-group

Skupina pro správu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False

az policy definition update

Aktualizujte definici zásady.

Aktualizujte definici zásady v daném předplatném nebo skupině pro správu s daným názvem použitím daných vlastností.

az policy definition update --name
                            [--add]
                            [--description]
                            [--display-name]
                            [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                            [--management-group]
                            [--metadata]
                            [--mode]
                            [--params]
                            [--remove]
                            [--rule --rules]
                            [--set]
                            [--version]

Příklady

Aktualizace zobrazovaného názvu definice zásady

az policy definition update --name MyPolicyDefinition --display-name "Updated display name goes here"

Povinné parametry

--name -n

Název definice zásady.

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
--description

Popis definice zásady

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--display-name

Zobrazovaný název definice zásady.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--management-group

Skupina pro správu.

--metadata

Metadata definice zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--mode -m

Režim definice zásad.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--params -p

Definice parametrů pravidla zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
--rule --rules

Pravidlo zásad. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Vlastnost Hodnota
Skupina parametrů: Generic Update Arguments
--version

Verze definice zásady.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost Hodnota
Default value: False
--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost Hodnota
Default value: False
--output -o

Výstupní formát

Vlastnost Hodnota
Default value: json
Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost Hodnota
Default value: False