Udostępnij przez


az policy attestation

Zarządzanie zaświadczaniami zasad zasobów.

Polecenia

Nazwa Opis Typ Stan
az policy attestation create

Utwórz zaświadczenie zasad.

Core ogólna dostępność
az policy attestation delete

Usuń istniejące zaświadczenie zasad.

Core ogólna dostępność
az policy attestation list

Wyświetl listę wszystkich zaświadczeń dla zasobu.

Core ogólna dostępność
az policy attestation show

Uzyskaj zaświadczenie zasad.

Core ogólna dostępność
az policy attestation update

Zaktualizuj istniejące zaświadczenie zasad.

Core ogólna dostępność

az policy attestation create

Utwórz zaświadczenie zasad.

az policy attestation create --attestation-name --name
                             --policy-assignment --policy-assignment-id
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Przykłady

Tworzenie zaświadczania w zakresie grupy zasobów dla przypisania zasad

az policy attestation create -g myRg -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Tworzenie zaświadczania w zakresie grupy zasobów dla przypisania zasad przy użyciu identyfikatora zasobu przypisania zasad

az policy attestation create -g myRg -n myAttestation \
  --policy-assignment "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/myPa"

Tworzenie zaświadczania w zakresie subskrypcji dla przypisania zestawu zasad

az policy attestation create -n myAttestation \
  --policy-assignment eeb18edc813c42d0ad5a9eab \
  --definition-reference-id auditVMPolicyReference

Tworzenie zaświadczania dla określonego zasobu przy użyciu identyfikatora zasobu

az policy attestation create \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  -n myAttestation --policy-assignment eeb18edc813c42d0ad5a9eab

Tworzenie zaświadczania w zakresie grupy zasobów przy użyciu wszystkich właściwości

az policy attestation create --attestation-name myAttestation -g myRg -a eeb18edc813c42d0ad5a9eab \
 --compliance-state Compliant --assessment-date 2023-01-01T08:29:18Z \
 --evidence source-uri=https://sampleuri.com description="Sample description for the sample uri" \
 --evidence source-uri=https://sampleuri2.com description="Sample description 2 for the sample uri 2" \
 --expires-on 2024-08-01T05:29:18Z --owner user@myOrg.com --metadata Location=NYC Dept=ACC \
 --definition-reference-id auditVMPolicyReference

Parametry wymagane

--attestation-name --name -n

Nazwa zaświadczania.

--policy-assignment --policy-assignment-id -a

Identyfikator zasobu przypisania zasad, dla którego zaświadczanie ustawia stan.

Właściwość Wartość
Grupa parametrów: Properties Arguments

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--assessment-date

Czas oceny dowodów.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--comments

Komentarze opisujące, dlaczego to zaświadczanie zostało utworzone.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--compliance-state

Stan zgodności, który należy ustawić na zasobie.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: Compliant, NonCompliant, Unknown
--definition-reference-id

Identyfikator odwołania definicji zasad z definicji zestawu zasad, dla którego zaświadczenie ustawia stan. Jeśli przypisanie zasad przypisuje definicję zestawu zasad, zaświadczanie może wybrać definicję w ramach definicji zestawu z tą właściwością lub pominąć tę właściwość i ustawić stan dla całej definicji zestawu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--evidence

Dowody obsługujące stan zgodności ustawiony w tym zaświadczeniu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--expires-on

Czas wygaśnięcia stanu zgodności.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--metadata

Dodatkowe metadane w parach klucz=wartość rozdzielanych spacjami na potrzeby zaświadczania. Spowoduje to zastąpienie wszystkich istniejących metadanych dla zaświadczania.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--namespace

Przestrzeń nazw dostawcy (np. Microsoft.Provider).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--owner

Osoba odpowiedzialna za ustawienie stanu zasobu. Ta wartość jest zazwyczaj identyfikatorem obiektu usługi Azure Active Directory.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--parent

Ścieżka nadrzędna (np. resourceTypeA/nameA/resourceTypeB/nameB).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource --resource-id

Identyfikator zasobu lub nazwa zasobu. Jeśli podano nazwę, podaj grupę zasobów i inne odpowiednie argumenty identyfikatora zasobu.

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Scope Arguments
--resource-type

Typ zasobu (np. resourceTypeC).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az policy attestation delete

Usuń istniejące zaświadczenie zasad.

az policy attestation delete --attestation-name --name
                             [--namespace]
                             [--parent]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Przykłady

Usuwanie zaświadczania w zakresie grupy zasobów

az policy attestation delete -g myRg -n myAttestation

Parametry wymagane

--attestation-name --name -n

Nazwa zaświadczania.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--namespace

Przestrzeń nazw dostawcy (np. Microsoft.Provider).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--parent

Ścieżka nadrzędna (np. resourceTypeA/nameA/resourceTypeB/nameB).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource --resource-id

Identyfikator zasobu lub nazwa zasobu. Jeśli podano nazwę, podaj grupę zasobów i inne odpowiednie argumenty identyfikatora zasobu.

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Scope Arguments
--resource-type

Typ zasobu (np. resourceTypeC).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az policy attestation list

Wyświetl listę wszystkich zaświadczeń dla zasobu.

az policy attestation list [--filter]
                           [--resource --resource-id]
                           [--resource-group]
                           [--top]

Przykłady

Wyświetlanie listy wszystkich zaświadczeń zasad w zakresie subskrypcji

az policy attestation list

Wyświetl listę dwóch pierwszych zaświadczeń zasad w zakresie grupy zasobów

az policy attestation list -g myRg --top 2

Wyświetl listę wszystkich zaświadczeń, które mają identyfikator przypisania zasad myPolicyAssignment

az policy attestation list --filter "PolicyAssignmentId eq '/subscriptions/35ee058e-5fa0-414c-8145-3ebb8d09b6e2/providers/microsoft.authorization/policyassignments/b101830944f246d8a14088c5'"

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--filter

Wyrażenie filtru OData.

--resource --resource-id

Identyfikator zasobu.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

--top

Maksymalna liczba rekordów do zwrócenia.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az policy attestation show

Uzyskaj zaświadczenie zasad.

az policy attestation show --attestation-name --name
                           [--namespace]
                           [--parent]
                           [--resource --resource-id]
                           [--resource-group]
                           [--resource-type]

Przykłady

Pokaż zaświadczenie w subskrypcji.

az policy attestation show --attestation-name myAttestation

Parametry wymagane

--attestation-name --name -n

Nazwa zaświadczania.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--namespace

Przestrzeń nazw dostawcy (np. Microsoft.Provider).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--parent

Ścieżka nadrzędna (np. resourceTypeA/nameA/resourceTypeB/nameB).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource --resource-id

Identyfikator zasobu lub nazwa zasobu. Jeśli podano nazwę, podaj grupę zasobów i inne odpowiednie argumenty identyfikatora zasobu.

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Scope Arguments
--resource-type

Typ zasobu (np. resourceTypeC).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az policy attestation update

Zaktualizuj istniejące zaświadczenie zasad.

az policy attestation update --attestation-name --name
                             [--assessment-date]
                             [--comments]
                             [--compliance-state {Compliant, NonCompliant, Unknown}]
                             [--definition-reference-id]
                             [--evidence]
                             [--expires-on]
                             [--metadata]
                             [--namespace]
                             [--owner]
                             [--parent]
                             [--policy-assignment --policy-assignment-id]
                             [--resource --resource-id]
                             [--resource-group]
                             [--resource-type]

Przykłady

Aktualizowanie zaświadczania w zakresie zasobów

az policy attestation update --attestation-name myAttestation \
  --resource "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myRg/providers/Microsoft.Compute/virtualMachines/myVm" \
  --comments "Adding comments for this attestation"

Parametry wymagane

--attestation-name --name -n

Nazwa zaświadczania.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--assessment-date

Czas oceny dowodów.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--comments

Komentarze opisujące, dlaczego to zaświadczanie zostało utworzone.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--compliance-state

Stan zgodności, który należy ustawić na zasobie.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: Compliant, NonCompliant, Unknown
--definition-reference-id

Identyfikator odwołania definicji zasad z definicji zestawu zasad, dla którego zaświadczenie ustawia stan. Jeśli przypisanie zasad przypisuje definicję zestawu zasad, zaświadczanie może wybrać definicję w ramach definicji zestawu z tą właściwością lub pominąć tę właściwość i ustawić stan dla całej definicji zestawu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--evidence

Dowody obsługujące stan zgodności ustawiony w tym zaświadczeniu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--expires-on

Czas wygaśnięcia stanu zgodności.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--metadata

Dodatkowe metadane w parach klucz=wartość rozdzielanych spacjami na potrzeby zaświadczania. Spowoduje to zastąpienie wszystkich istniejących metadanych dla zaświadczania.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--namespace

Przestrzeń nazw dostawcy (np. Microsoft.Provider).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--owner

Osoba odpowiedzialna za ustawienie stanu zasobu. Ta wartość jest zazwyczaj identyfikatorem obiektu usługi Azure Active Directory.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--parent

Ścieżka nadrzędna (np. resourceTypeA/nameA/resourceTypeB/nameB).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--policy-assignment --policy-assignment-id -a

Identyfikator zasobu przypisania zasad, dla którego zaświadczanie ustawia stan.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--resource --resource-id

Identyfikator zasobu lub nazwa zasobu. Jeśli podano nazwę, podaj grupę zasobów i inne odpowiednie argumenty identyfikatora zasobu.

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Scope Arguments
--resource-type

Typ zasobu (np. resourceTypeC).

Właściwość Wartość
Grupa parametrów: Resource ID Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False