az ad sp

  • Odwołanie

Zarządzanie jednostkami usługi Azure Active Directory na potrzeby uwierzytelniania automatyzacji.

Polecenia

az ad sp create

Tworzenie jednostki usługi.
az ad sp create-for-rbac

Utwórz jednostkę usługi i skonfiguruj jej dostęp do zasobów platformy Azure.
az ad sp credential

Zarządzanie poświadczeniami jednostki usługi.
az ad sp credential delete

Usuń poświadczenia jednostki usługi.
az ad sp credential list

Wyświetl listę poświadczeń jednostki usługi.
az ad sp credential reset

Zresetuj poświadczenia jednostki usługi.
az ad sp delete

Usuń jednostkę usługi i jej przypisania ról.
az ad sp list

Wyświetlanie listy jednostek usługi.
az ad sp owner

Zarządzanie właścicielami jednostki usługi.
az ad sp owner list

Wyświetlanie listy właścicieli jednostki usługi.
az ad sp show

Uzyskaj szczegółowe informacje o jednostce usługi.
az ad sp update

Aktualizowanie jednostki usługi.

az ad sp create

Edytuj

Tworzenie jednostki usługi.

az ad sp create --id

Przykłady

Tworzenie jednostki usługi. (automatycznie wygenerowane)

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

Parametry wymagane

--id

Identyfikator URI, identyfikator aplikacji lub identyfikator obiektu skojarzonej aplikacji.

az ad sp create-for-rbac

Edytuj

Utwórz jednostkę usługi i skonfiguruj jej dostęp do zasobów platformy Azure.

Dane wyjściowe zawierają poświadczenia, które należy chronić. Pamiętaj, aby nie uwzględniać tych poświadczeń w kodzie ani nie ewidencjonować ich w systemie kontroli kodu źródłowego. Alternatywnie rozważ użycie tożsamości zarządzanych , jeśli są dostępne, aby uniknąć konieczności używania poświadczeń.

Domyślnie to polecenie nie przypisuje żadnej roli do jednostki usługi. Możesz użyć opcji --role i --scopes, aby przypisać określoną rolę i zawęzić zakres do zasobu lub grupy zasobów. Możesz również użyć az role assignment create polecenia , aby utworzyć przypisania ról dla tej jednostki usługi później. Aby uzyskać więcej informacji, zobacz kroki dodawania przypisania roli .

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

Przykłady

Utwórz bez przypisania roli.

az ad sp create-for-rbac

Utwórz przy użyciu niestandardowej nazwy wyświetlanej.

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

Utwórz za pomocą przypisań ról Współautor w określonych zakresach. Aby pobrać bieżący identyfikator subskrypcji, uruchom polecenie `az account show --query id --output tsv`.

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

Utwórz przy użyciu certyfikatu z podpisem własnym.

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

Utwórz przy użyciu certyfikatu z podpisem własnym i zapisz go w usłudze KeyVault.

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

Utwórz przy użyciu istniejącego certyfikatu w usłudze KeyVault.

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

Parametry opcjonalne

--cert

Certyfikat do użycia dla poświadczeń.

--create-cert

Utwórz certyfikat z podpisem własnym do użycia dla poświadczeń. Tylko bieżący użytkownik systemu operacyjnego ma uprawnienie do odczytu/zapisu do tego certyfikatu.

--display-name --name -n

Nazwa wyświetlana jednostki usługi. Jeśli nie istnieje, wartość domyślna to azure-cli-%Y-%m-%d-%H-%M-%S, gdzie sufiks to czas tworzenia.

--keyvault

Nazwa lub identyfikator usługi KeyVault do użycia do tworzenia lub pobierania certyfikatów.

--role

Rola jednostki usługi.

--scopes

Rozdzielona spacjami lista zakresów, do których ma zastosowanie przypisanie roli jednostki usługi. np. /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroups, /subscriptions/0b1f6471-1bf0-4dda-aec3-111122223333/resourceGroups/myGroup/providers/Microsoft.Compute/virtualMachines/myVM.

--sdk-auth

Dane wyjściowe powodują zgodność z plikiem uwierzytelniania zestawu Azure SDK.

akceptowane wartości: false, true
--skip-assignment

No-op.

akceptowane wartości: false, true
--years

Liczba lat, dla których poświadczenia będą prawidłowe. Ustawienie domyślne: 1 rok.

az ad sp delete

Edytuj

Usuń jednostkę usługi i jej przypisania ról.

az ad sp delete --id

Przykłady

Usuń jednostkę usługi i jej przypisania ról. (automatycznie wygenerowane)

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

Parametry wymagane

--id

Nazwa główna usługi lub identyfikator obiektu.

az ad sp list

Edytuj

Wyświetlanie listy jednostek usługi.

W przypadku małych opóźnień domyślnie zostanie zwróconych tylko pierwszych 100, chyba że podasz argumenty filtru lub użyjesz wartości "--all".

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

Parametry opcjonalne

--all

Wyświetl listę wszystkich jednostek, spodziewaj się długiego opóźnienia w przypadku dużej organizacji.

--display-name

Nazwa wyświetlana obiektu lub jego prefiks.

--filter

Filtr OData, np. --filter "displayname eq 'test' and servicePrincipalType eq 'Application'".

--show-mine

Wyświetlanie listy jednostek należących do bieżącego użytkownika.

--spn

Nazwa główna usługi.

az ad sp show

Edytuj

Uzyskaj szczegółowe informacje o jednostce usługi.

az ad sp show --id

Przykłady

Pobierz szczegóły jednostki usługi za pomocą identyfikatora appId.

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

Pobierz szczegóły jednostki usługi o identyfikatorze.

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

Uzyskaj szczegółowe informacje o jednostce usługi z identyfikatorem URI identyfikatora.

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

Parametry wymagane

--id

Nazwa główna usługi lub identyfikator obiektu.

az ad sp update

Edytuj

Aktualizowanie jednostki usługi.

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

Przykłady

aktualizowanie jednostki usługi (automatycznie wygenerowanej)

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

Parametry wymagane

--id

Nazwa główna usługi lub identyfikator obiektu.

Parametry opcjonalne

--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string lub ciąg JSON>.

--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list OR --remove propertyToRemove.

--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=.