Feedback

az keyvault certificate

  • Referenz

Verwalten Sie Zertifikate.

Befehle

az keyvault certificate backup

Sichern Sie das angegebene Zertifikat.
az keyvault certificate contact

Verwalten von Kontakten für die Zertifikatverwaltung.
az keyvault certificate contact add

Fügen Sie dem angegebenen Tresor einen Kontakt hinzu, um Benachrichtigungen über Zertifikatvorgänge zu erhalten.
az keyvault certificate contact delete

Entfernen Sie einen Zertifikatkontakt aus dem angegebenen Tresor.
az keyvault certificate contact list

Listet die Zertifikatkontakte für einen angegebenen Schlüsseltresor auf.
az keyvault certificate create

Erstellen Sie ein Key Vault Zertifikat.
az keyvault certificate delete

Löscht ein Zertifikat aus einem angegebenen Schlüsseltresor.
az keyvault certificate download

Laden Sie den öffentlichen Teil eines Key Vault Zertifikats herunter.
az keyvault certificate get-default-policy

Rufen Sie die Standardrichtlinie für selbst signierte Zertifikate ab.
az keyvault certificate import

Importieren Sie ein Zertifikat in KeyVault.
az keyvault certificate issuer

Verwalten von Zertifikatausstellerinformationen.
az keyvault certificate issuer admin

Verwalten von Administratorinformationen für Zertifikataussteller.
az keyvault certificate issuer admin add

Fügen Sie Administratordetails für einen angegebenen Zertifikataussteller hinzu.
az keyvault certificate issuer admin delete

Entfernen Sie Administratordetails für den angegebenen Zertifikataussteller.
az keyvault certificate issuer admin list

Listenadministratoren für einen angegebenen Zertifikataussteller auf.
az keyvault certificate issuer create

Erstellen Sie einen Zertifikatausstellerdatensatz.
az keyvault certificate issuer delete

Löscht den angegebenen Zertifikataussteller.
az keyvault certificate issuer list

Listen von Zertifikatausstellern für einen angegebenen Schlüsseltresor auf.
az keyvault certificate issuer show

Listet den angegebenen Zertifikataussteller auf.
az keyvault certificate issuer update

Aktualisieren eines Zertifikatausstellerdatensatzs.
az keyvault certificate list

Listen Sie Zertifikate in einem angegebenen Schlüsseltresor auf.
az keyvault certificate list-deleted

Listet die gelöschten Zertifikate im angegebenen Tresor auf, die derzeit für die Wiederherstellung verfügbar sind.
az keyvault certificate list-versions

Listet die Versionen eines Zertifikats auf.
az keyvault certificate pending

Verwalten von ausstehenden Zertifikaterstellungsvorgängen.
az keyvault certificate pending delete

Löscht den Erstellungsvorgang für ein bestimmtes Zertifikat.
az keyvault certificate pending merge

Zusammenführen eines Zertifikats oder einer Zertifikatkette mit einem schlüsselpaar, das auf dem Server vorhanden ist.
az keyvault certificate pending show

Ruft den Erstellungsvorgang eines Zertifikats ab.
az keyvault certificate purge

Löscht endgültig das angegebene gelöschte Zertifikat.
az keyvault certificate recover

Stellt das gelöschte Zertifikat wieder in seine aktuelle Version unter /Zertifikate zurück.
az keyvault certificate restore

Stellt ein gesichertes Zertifikat in einen Tresor wiederhergestellt.
az keyvault certificate set-attributes

Aktualisiert die angegebenen Attribute, die dem jeweiligen Zertifikat zugeordnet sind.
az keyvault certificate show

Ruft Informationen zu einem Zertifikat ab.
az keyvault certificate show-deleted

Ruft Informationen zu dem angegebenen gelöschten Zertifikat ab.

az keyvault certificate backup

Bearbeiten

Sichern Sie das angegebene Zertifikat.

Fordert an, dass eine Sicherung des angegebenen Zertifikats auf den Client heruntergeladen wird. Alle Versionen des Zertifikats werden heruntergeladen. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Sicherung".

az keyvault certificate backup --file
                               [--id]
                               [--name]
                               [--vault-name]

Erforderliche Parameter

--file -f

Lokaler Dateipfad, in dem die Zertifikatsicherung gespeichert werden soll.

Optionale Parameter

--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate create

Bearbeiten

Erstellen Sie ein Key Vault Zertifikat.

Zertifikate können als Geheimschlüssel für bereitgestellte virtuelle Computer verwendet werden.

az keyvault certificate create --name
                               --policy
                               --vault-name
                               [--disabled {false, true}]
                               [--tags]
                               [--validity]

Beispiele

Erstellen Sie ein selbstsigniertes Zertifikat mit der Standardrichtlinie und fügen Sie es einem virtuellen Computer hinzu.

az keyvault certificate create --vault-name vaultname -n cert1 \
  -p "$(az keyvault certificate get-default-policy)"

secrets=$(az keyvault secret list-versions --vault-name vaultname \
  -n cert1 --query "[?attributes.enabled].id" -o tsv)

vm_secrets=$(az vm secret format -s "$secrets")

az vm create -g group-name -n vm-name --admin-username deploy  \
  --image debian --secrets "$vm_secrets"

Erforderliche Parameter

--name -n

Name des Zertifikats.

--policy -p

JSON-codierte Richtliniendefinition. Verwenden Sie @{file} zum Laden aus einer Datei(z. B. @my_policy.json).

--vault-name

Name des Tresors.

Optionale Parameter

--disabled

Erstellen Sie das Zertifikat im deaktivierten Zustand.

Zulässige Werte: false, true
--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--validity

Die Anzahl der Monate, für die das Zertifikat gültig ist. Überschreibt den angegebenen Wert mit --policy/-p.

az keyvault certificate delete

Bearbeiten

Löscht ein Zertifikat aus einem angegebenen Schlüsseltresor.

Löscht alle Versionen eines Zertifikatobjekts zusammen mit seiner zugeordneten Richtlinie. Das Löschen des Zertifikats kann nicht verwendet werden, um einzelne Versionen eines Zertifikatobjekts zu entfernen. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Löschen".

az keyvault certificate delete [--id]
                               [--name]
                               [--vault-name]

Optionale Parameter

--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate download

Bearbeiten

Laden Sie den öffentlichen Teil eines Key Vault Zertifikats herunter.

Das Zertifikat, das entweder als PEM oder DER formatiert ist. PEM ist die Standardeinstellung.

az keyvault certificate download --file
                                 [--encoding {DER, PEM}]
                                 [--id]
                                 [--name]
                                 [--vault-name]
                                 [--version]

Beispiele

Laden Sie ein Zertifikat als PEM herunter, und überprüfen Sie ihren Fingerabdruck in opensl.

az keyvault certificate download --vault-name vault -n cert-name -f cert.pem && \
openssl x509 -in cert.pem -inform PEM  -noout -sha1 -fingerprint

Laden Sie ein Zertifikat als DER herunter, und überprüfen Sie ihren Fingerabdruck in opensl.

az keyvault certificate download --vault-name vault -n cert-name -f cert.crt -e DER && \
openssl x509 -in cert.crt -inform DER  -noout -sha1 -fingerprint

Erforderliche Parameter

--file -f

Datei zum Empfangen des Binärzertifikatinhalts.

Optionale Parameter

--encoding -e

Codierung des Zertifikats. DER erstellt ein binäres X509-Zertifikat, und PEM erstellt ein Base64 PEM x509-Zertifikat.

Zulässige Werte: DER, PEM
Standardwert: PEM
--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

--version -v

Die Zertifikatversion. Wenn nicht angegeben, wird die neueste Version verwendet.

az keyvault certificate get-default-policy

Bearbeiten

Rufen Sie die Standardrichtlinie für selbst signierte Zertifikate ab.

Diese Standardrichtlinie kann in Verbindung mit az keyvault create dem Erstellen eines selbst signierten Zertifikats verwendet werden. Die Standardrichtlinie kann auch als Ausgangspunkt zum Erstellen von abgeleiteten Richtlinien verwendet werden.

Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/key-vault/certificates/about-certificates#certificate-policy.

az keyvault certificate get-default-policy [--scaffold]

Beispiele

Erstellen eines selbst signierten Zertifikats mit der Standardrichtlinie

az keyvault certificate create --vault-name vaultname -n cert1 \
  -p "$(az keyvault certificate get-default-policy)"

Optionale Parameter

--scaffold

Erstellen Sie eine voll formierte Richtlinienstruktur mit Standardwerten.

az keyvault certificate import

Bearbeiten

Importieren Sie ein Zertifikat in KeyVault.

Zertifikate können auch als Geheimschlüssel für bereitgestellte virtuelle Computer verwendet werden.

az keyvault certificate import --file
                               --name
                               --vault-name
                               [--disabled {false, true}]
                               [--password]
                               [--policy]
                               [--tags]

Beispiele

Erstellen Sie einen Dienstprinzipal mit einem Zertifikat, fügen Sie das Zertifikat zu Key Vault hinzu und stellen Sie eine VM mit diesem Zertifikat bereit.

service_principal=$(az ad sp create-for-rbac --create-cert)

cert_file=$(echo $service_principal | jq .fileWithCertAndPrivateKey -r)

az keyvault create -g my-group -n vaultname

az keyvault certificate import --vault-name vaultname -n cert_name -f cert_file

secrets=$(az keyvault secret list-versions --vault-name vaultname \
  -n cert1 --query "[?attributes.enabled].id" -o tsv)

vm_secrets=$(az vm secret format -s "$secrets")

az vm create -g group-name -n vm-name --admin-username deploy  \
  --image debian --secrets "$vm_secrets"

Erforderliche Parameter

--file -f

PKCS12-Datei oder PEM-Datei, die das Zertifikat und den privaten Schlüssel enthält.

--name -n

Name des Zertifikats.

--vault-name

Name des Tresors.

Optionale Parameter

--disabled

Importieren Sie das Zertifikat im deaktivierten Zustand.

Zulässige Werte: false, true
--password

Wenn der private Schlüssel im Zertifikat verschlüsselt ist, wird das Kennwort für die Verschlüsselung verwendet.

--policy -p

JSON-codierte Richtliniendefinition. Verwenden Sie @{file} zum Laden aus einer Datei(z. B. @my_policy.json).

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

az keyvault certificate list

Bearbeiten

Listen Sie Zertifikate in einem angegebenen Schlüsseltresor auf.

Der Vorgang "GetCertificates" gibt die Gruppe von Zertifikatressourcen im angegebenen Schlüsseltresor zurück. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Listen".

az keyvault certificate list [--id]
                             [--include-pending {false, true}]
                             [--maxresults]
                             [--vault-name]

Optionale Parameter

--id

Voll-URI des Tresors oder HSM. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--include-pending

Gibt an, ob Zertifikate eingeschlossen werden sollen, die nicht vollständig bereitgestellt werden.

Zulässige Werte: false, true
--maxresults

Maximale Anzahl der Ergebnisse, die in einer Seite zurückgegeben werden sollen. Wenn der Dienst nicht angegeben wird, werden bis zu 25 Ergebnisse zurückgegeben.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate list-deleted

Bearbeiten

Listet die gelöschten Zertifikate im angegebenen Tresor auf, die derzeit für die Wiederherstellung verfügbar sind.

Der GetDeletedCertificates-Vorgang ruft die Zertifikate im aktuellen Tresor ab, die sich in einem gelöschten Zustand befinden und für die Wiederherstellung oder Löschung bereit sind. Dieser Vorgang enthält löschungsspezifische Informationen. Dieser Vorgang erfordert die Berechtigung "Zertifikate/get/list". Dieser Vorgang kann nur auf aktivierten Lösch-Tresoren aktiviert werden.

az keyvault certificate list-deleted --vault-name
                                     [--id]
                                     [--include-pending {false, true}]
                                     [--maxresults]

Erforderliche Parameter

--vault-name

Name des Tresors.

Optionale Parameter

--id

Vollständiger URI des Tresors. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--include-pending

Gibt an, ob Zertifikate eingeschlossen werden sollen, die nicht vollständig bereitgestellt werden.

Zulässige Werte: false, true
--maxresults

Maximale Anzahl der Ergebnisse, die in einer Seite zurückgegeben werden sollen. Wenn der Dienst nicht angegeben wird, werden bis zu 25 Ergebnisse zurückgegeben.

az keyvault certificate list-versions

Bearbeiten

Listet die Versionen eines Zertifikats auf.

Der GetCertificateVersions-Vorgang gibt die Versionen eines Zertifikats im angegebenen Schlüsseltresor zurück. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Listen".

az keyvault certificate list-versions [--id]
                                      [--maxresults]
                                      [--name]
                                      [--vault-name]

Optionale Parameter

--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--maxresults

Maximale Anzahl der Ergebnisse, die in einer Seite zurückgegeben werden sollen. Wenn der Dienst nicht angegeben wird, werden bis zu 25 Ergebnisse zurückgegeben.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate purge

Bearbeiten

Löscht endgültig das angegebene gelöschte Zertifikat.

Der Vorgang "PurgeDeletedCertificate" führt eine unumkehrbare Löschung des angegebenen Zertifikats ohne Möglichkeit zur Wiederherstellung durch. Der Vorgang ist nicht verfügbar, wenn die Wiederherstellungsstufe nicht 'Löschbar' angibt. Dieser Vorgang erfordert die Berechtigung "Zertifikat/Löschen".

az keyvault certificate purge [--id]
                              [--name]
                              [--vault-name]

Optionale Parameter

--id

Die Wiederherstellungs-ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Tresors. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate recover

Bearbeiten

Stellt das gelöschte Zertifikat wieder in seine aktuelle Version unter /Zertifikate zurück.

Der Operation "RecoverDeletedCertificate" führt die Umkehrung des Delete-Vorgangs aus. Der Vorgang ist in Tresoren anwendbar, die für das softe Löschen aktiviert sind, und muss während des Aufbewahrungsintervalls ausgestellt werden (verfügbar in den Attributen des gelöschten Zertifikats). Dieser Vorgang erfordert die Berechtigung "Zertifikate/Wiederherstellen".

az keyvault certificate recover [--id]
                                [--name]
                                [--vault-name]

Optionale Parameter

--id

Die Wiederherstellungs-ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Tresors. Erforderlich, wenn --id nicht angegeben wird.

az keyvault certificate restore

Bearbeiten

Stellt ein gesichertes Zertifikat in einen Tresor wiederhergestellt.

Stellt ein gesichertes Zertifikat und alle zugehörigen Versionen in einem Tresor wieder her. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Wiederherstellung".

az keyvault certificate restore --file
                                --vault-name

Erforderliche Parameter

--file -f

Lokale Zertifikatsicherung, von der das Zertifikat wiederhergestellt werden soll.

--vault-name

Name des Tresors.

az keyvault certificate set-attributes

Bearbeiten

Aktualisiert die angegebenen Attribute, die dem jeweiligen Zertifikat zugeordnet sind.

Der UpdateCertificate-Vorgang wendet das angegebene Update auf dem angegebenen Zertifikat an; die einzigen Aktualisierten Elemente sind die Attribute des Zertifikats. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Aktualisierung".

az keyvault certificate set-attributes [--enabled {false, true}]
                                       [--id]
                                       [--name]
                                       [--policy]
                                       [--tags]
                                       [--vault-name]
                                       [--version]

Optionale Parameter

--enabled

Aktivieren Sie das Zertifikat.

Zulässige Werte: false, true
--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--policy -p

JSON-codierte Richtliniendefinition. Verwenden Sie @{file} zum Laden aus einer Datei(z. B. @my_policy.json).

--tags

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

--version -v

Die Zertifikatversion. Wenn nicht angegeben, wird die neueste Version verwendet.

az keyvault certificate show

Bearbeiten

Ruft Informationen zu einem Zertifikat ab.

Ruft Informationen zu einem bestimmten Zertifikat ab. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Abrufen".

az keyvault certificate show [--id]
                             [--name]
                             [--vault-name]
                             [--version]

Optionale Parameter

--id

ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Key Vault. Erforderlich, wenn --id nicht angegeben wird.

--version -v

Die Zertifikatversion. Wenn nicht angegeben, wird die neueste Version verwendet.

az keyvault certificate show-deleted

Bearbeiten

Ruft Informationen zu dem angegebenen gelöschten Zertifikat ab.

Der GetDeletedCertificate-Vorgang ruft die gelöschten Zertifikatinformationen sowie seine Attribute ab, z. B. Aufbewahrungsintervall, geplantes permanentes Löschen und die aktuelle Löschebene. Dieser Vorgang erfordert die Berechtigung "Zertifikate/Abrufen".

az keyvault certificate show-deleted [--id]
                                     [--name]
                                     [--vault-name]

Optionale Parameter

--id

Die Wiederherstellungs-ID des Zertifikats. Wenn alle anderen "ID"-Argumente angegeben werden sollen, sollte nicht angegeben werden.

--name -n

Name des Zertifikats. Erforderlich, wenn --id nicht angegeben wird.

--vault-name

Name des Tresors. Erforderlich, wenn --id nicht angegeben wird.