Udostępnij za pośrednictwem

az ad sp

  • Odwołanie

Zarządzanie jednostkami usługi Entra firmy Microsoft.

Polecenia

Nazwa Opis Typ Stan
az ad sp create

Tworzenie jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp create-for-rbac

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

 Podstawowe funkcje Ogólna dostępność
az ad sp credential

Zarządzanie hasłem lub poświadczeniami certyfikatu jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp credential delete

Usuń hasło lub poświadczenia certyfikatu jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp credential list

Wyświetlanie listy metadanych poświadczeń jednostki usługi lub poświadczeń certyfikatu. (Zawartość hasła lub poświadczenia certyfikatu nie jest pobierana).

 Podstawowe funkcje Ogólna dostępność
az ad sp credential reset

Zresetuj hasło lub poświadczenia certyfikatu jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp delete

Usuwanie jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp list

Wyświetlanie listy jednostek usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp owner

Zarządzanie właścicielami jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp owner list

Wyświetlanie listy właścicieli jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp show

Uzyskaj szczegóły jednostki usługi.

 Podstawowe funkcje Ogólna dostępność
az ad sp update

Aktualizowanie jednostki usługi.

 Podstawowe funkcje Ogólna dostępność

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.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

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]
                         [--json-auth {false, true}]
                         [--keyvault]
                         [--role]
                         [--scopes]
                         [--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 przy użyciu 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/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroup1 /subscriptions/00000000-0000-0000-0000-000000000000/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ń. W przypadku użycia z elementem --keyvault,wskazuje nazwę certyfikatu do użycia lub utworzenia. W przeciwnym razie podaj ciąg certyfikatu publicznego w formacie PEM lub DER. Użyj @{path} polecenia , aby załadować plik. Nie dołączaj informacji o kluczu prywatnym.

--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. Użyj polecenia , --keyvault aby utworzyć certyfikat w usłudze Key Vault. W przeciwnym razie certyfikat zostanie utworzony lokalnie.

Domyślna wartość: False
--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 sufiksem jest czas tworzenia.

--json-auth --sdk-auth
Przestarzałe

Opcja "--sdk-auth" została wycofana i zostanie usunięta w przyszłej wersji.

Poświadczenia jednostki usługi wyjściowej wraz z punktami końcowymi w chmurze w formacie JSON.

Dopuszczalne wartości: false, true
--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. subskrypcje/0b1f6471-1bf0-4dda-aec3-1111222223333/resourceGroups/myGroups, /subscriptions/0b1f6471-1bf0-4dda-aec3-11112222333/resourceGroups/myGroups/providers/Microsoft.Compute/virtualMachines/myVM.

--years

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az ad sp delete

Edytuj

Usuwanie jednostki usługi.

az ad sp delete --id

Przykłady

Usuwanie jednostki usługi.

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

Parametry wymagane

--id

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az ad sp list

Edytuj

Wyświetlanie listy jednostek usługi.

W przypadku małych opóźnień domyślnie zwracane będą tylko pierwsze 100 pierwszych 100, chyba że podasz argumenty filtru lub użyj polecenia "--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.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

az ad sp show

Edytuj

Uzyskaj szczegóły jednostki 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.

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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

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 or JSON string>.

Domyślna wartość: []
--force-string

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

Domyślna wartość: False
--remove

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

Domyślna wartość: []
--set

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

Domyślna wartość: []
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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 polecenia az account set -s NAME_OR_ID.

--verbose

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