Feedback

az ad sp

  • Referenz

Verwalten sie Azure Active Directory-Dienstprinzipale für die Automatisierungsauthentifizierung.

Befehle

az ad sp create

Erstellen eines Dienstprinzipals
az ad sp create-for-rbac

Erstellen Sie einen Dienstprinzipal, und konfigurieren Sie seinen Zugriff auf Azure-Ressourcen.
az ad sp credential

Verwalten sie die Anmeldeinformationen eines Dienstprinzipals.
az ad sp credential delete

Löschen Sie die Anmeldeinformationen eines Dienstprinzipals.
az ad sp credential list

Auflisten der Anmeldeinformationen eines Dienstprinzipals.
az ad sp credential reset

Zurücksetzen einer Dienstprinzipal-Anmeldeinformationen.
az ad sp delete

Löschen Eines Dienstprinzipals und seiner Rollenzuweisungen.
az ad sp list

Listendienstprinzipale.
az ad sp owner

Verwalten von Dienstprinzipalbesitzern.
az ad sp owner list

Dienstprinzipalbesitzer auflisten.
az ad sp show

Rufen Sie die Details eines Dienstprinzipals ab.
az ad sp update

Aktualisieren eines Dienstprinzipals.

az ad sp create

Bearbeiten

Erstellen eines Dienstprinzipals

az ad sp create --id

Beispiele

Erstellen eines Dienstprinzipals (automatisch generiert)

az ad sp create --id 00000000-0000-0000-0000-000000000000

Erforderliche Parameter

--id

Bezeichner-URI, Anwendungs-ID oder Objekt-ID der zugehörigen Anwendung.

az ad sp create-for-rbac

Bearbeiten

Erstellen Sie einen Dienstprinzipal, und konfigurieren Sie seinen Zugriff auf Azure-Ressourcen.

Die Ausgabe enthält Anmeldeinformationen, die Sie schützen müssen. Schließen Sie diese Anmeldeinformationen nicht in Ihren Code ein, und checken Sie sie nicht in Ihre Quellcodeverwaltung ein. Verwenden Sie als Alternative ggf. verwaltete Identitäten (sofern verfügbar), um zu vermeiden, dass die Verwendung von Anmeldeinformationen erforderlich ist.

Standardmäßig weist dieser Befehl dem Dienstprinzipal keine Rolle zu. Sie können --role und --scopes verwenden, um eine bestimmte Rolle zuzuweisen und den Bereich einer Ressource oder Ressourcengruppe einzugrenzen. Sie können auch rollenzuweisungen az role assignment create für diesen Dienstprinzipal später erstellen. Weitere Informationen finden Sie in den Schritten zum Hinzufügen einer Rollenzuweisung .

az ad sp create-for-rbac [--cert]
                         [--create-cert]
                         [--display-name]
                         [--keyvault]
                         [--role]
                         [--scopes]
                         [--sdk-auth {false, true}]
                         [--skip-assignment {false, true}]
                         [--years]

Beispiele

Erstellen ohne Rollenzuweisung.

az ad sp create-for-rbac

Erstellen Sie einen benutzerdefinierten Anzeigenamen.

az ad sp create-for-rbac -n "MyApp"

Erstellen Sie mit einer Mitwirkenden-Rollenzuweisung für bestimmte Bereiche. Um die aktuelle Abonnement-ID abzurufen, führen Sie "az account show --query id --output tsv" aus.

az ad sp create-for-rbac -n "MyApp" --role Contributor --scopes /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup1} /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup2}

Erstellen Sie ein selbstsigniertes Zertifikat.

az ad sp create-for-rbac --create-cert

Erstellen Sie ein selbstsigniertes Zertifikat, und speichern Sie es in KeyVault.

az ad sp create-for-rbac --keyvault MyVault --cert CertName --create-cert

Erstellen Sie das vorhandene Zertifikat in KeyVault.

az ad sp create-for-rbac --keyvault MyVault --cert CertName

Optionale Parameter

--cert

Zertifikat, das für Anmeldeinformationen verwendet werden soll.

--create-cert

Erstellen Sie ein selbstsigniertes Zertifikat, das für die Anmeldeinformationen verwendet werden soll. Nur der aktuelle Betriebssystembenutzer verfügt über Lese-/Schreibberechtigungen für dieses Zertifikat.

--display-name --name -n

Anzeigename des Dienstprinzipals. Wenn nicht vorhanden, ist die Standardeinstellung azure-cli-%Y-%m-%d-%H-%M-%S, wobei das Suffix die Zeit der Erstellung ist.

--keyvault

Name oder ID eines KeyVault-Werts, der zum Erstellen oder Abrufen von Zertifikaten verwendet werden soll.

--role

Rolle des Dienstprinzipals.

--scopes

Leertrennte Liste der Bereiche, auf die die Rollenzuweisung des Dienstprinzipals angewendet wird. z. B. /subscriptions/0b1f6471-1bf0-4dda-aec3-11122223333/resourceGroups/myGroup, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122222333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

--sdk-auth

Ausgabeergebnis in kompatibler Azure SDK-Authentifizierungsdatei.

Zulässige Werte: false, true
--skip-assignment

No-op.

Zulässige Werte: false, true
--years

Anzahl der Jahre, für die die Anmeldeinformationen gültig sind. Standard: 1 Jahr.

az ad sp delete

Bearbeiten

Löschen Eines Dienstprinzipals und seiner Rollenzuweisungen.

az ad sp delete --id

Beispiele

Löschen Eines Dienstprinzipals und seiner Rollenzuweisungen. (automatisch generiert)

az ad sp delete --id 00000000-0000-0000-0000-000000000000

Erforderliche Parameter

--id

Dienstprinzipalname oder Objekt-ID.

az ad sp list

Bearbeiten

Listendienstprinzipale.

Bei niedriger Latenz wird standardmäßig nur die erste 100 zurückgegeben, es sei denn, Sie geben Filterargumente an oder verwenden "--all".

az ad sp list [--all]
              [--display-name]
              [--filter]
              [--show-mine]
              [--spn]

Optionale Parameter

--all

Listet alle Entitäten auf, erwartet eine lange Verzögerung, wenn es sich unter einer großen Organisation befindet.

--display-name

Der Anzeigename oder das Präfix des Objekts.

--filter

OData-Filter, z. B. --filter "displayname eq 'test' and servicePrincipalType eq 'Application'".

--show-mine

Listet Entitäten auf, die dem aktuellen Benutzer gehören.

--spn

Dienstprinzipalname.

az ad sp show

Bearbeiten

Rufen Sie die Details eines Dienstprinzipals ab.

az ad sp show --id

Beispiele

Rufen Sie die Details eines Dienstprinzipals mit appId ab.

az ad sp show --id 00000000-0000-0000-0000-000000000000

Rufen Sie die Details eines Dienstprinzipals mit id ab.

az ad sp show --id 00000000-0000-0000-0000-000000000000

Rufen Sie die Details eines Dienstprinzipals mit Bezeichner-URI ab.

az ad sp show --id api://myapp

Erforderliche Parameter

--id

Dienstprinzipalname oder Objekt-ID.

az ad sp update

Bearbeiten

Aktualisieren eines Dienstprinzipals.

az ad sp update --id
                [--add]
                [--force-string]
                [--remove]
                [--set]

Beispiele

Aktualisieren eines Dienstprinzipals (automatisch generiert)

az ad sp update --id 00000000-0000-0000-0000-000000000000 --set groupMembershipClaims=All

Erforderliche Parameter

--id

Dienstprinzipalname oder Objekt-ID.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

--remove

Entfernen einer Eigenschaft oder eines Elements aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftspfad und einen festzulegenden Wert angeben. Beispiel: --set property1.property2=.