az ad app

  • Reference

Správa aplikací Microsoft Entra

Příkazy

Name Description Typ Stav
az ad app create

Vytvořte aplikaci.

 Základ GA
az ad app credential

Umožňuje spravovat heslo aplikace nebo přihlašovací údaje certifikátu.

 Základ GA
az ad app credential delete

Odstraňte heslo nebo přihlašovací údaje certifikátu aplikace.

 Základ GA
az ad app credential list

Uveďte heslo aplikace nebo metadata přihlašovacích údajů certifikátu. (Obsah přihlašovacích údajů hesla nebo certifikátu není možné načíst.)

 Základ GA
az ad app credential reset

Resetujte heslo aplikace nebo přihlašovací údaje certifikátu.

 Základ GA
az ad app delete

Odstraňte aplikaci.

 Základ GA
az ad app federated-credential

Správa přihlašovacích údajů federované identity aplikace

 Základ GA
az ad app federated-credential create

Vytvořte přihlašovací údaje federované identity aplikace.

 Základ GA
az ad app federated-credential delete

Odstraňte přihlašovací údaje federované identity aplikace.

 Základ GA
az ad app federated-credential list

Výpis přihlašovacích údajů federované identity aplikace

 Základ GA
az ad app federated-credential show

Zobrazení přihlašovacích údajů federované identity aplikace

 Základ GA
az ad app federated-credential update

Aktualizujte přihlašovací údaje federované identity aplikace.

 Základ GA
az ad app list

Zobrazení seznamu aplikací

 Základ GA
az ad app owner

Správa vlastníků aplikací

 Základ GA
az ad app owner add

Přidejte vlastníka aplikace.

 Základ GA
az ad app owner list

Vypsat vlastníky aplikací

 Základ GA
az ad app owner remove

Odeberte vlastníka aplikace.

 Základ GA
az ad app permission

Umožňuje spravovat oprávnění OAuth2 aplikace.

 Základ GA
az ad app permission add

Přidejte oprávnění rozhraní API.

 Základ GA
az ad app permission admin-consent

Udělte aplikaci a delegovaná oprávnění prostřednictvím souhlasu správce.

 Základ GA
az ad app permission delete

Odeberte oprávnění rozhraní API.

 Základ GA
az ad app permission grant

Udělte aplikaci delegovaná oprávnění rozhraní API.

 Základ GA
az ad app permission list

Výpis oprávnění rozhraní API, která aplikace požadovala.

 Základ GA
az ad app permission list-grants

Výpis udělení oprávnění Oauth2

 Základ GA
az ad app show

Získejte podrobnosti o aplikaci.

 Základ GA
az ad app update

Aktualizujte aplikaci.

 Základ GA

az ad app create

Upravit

Vytvořte aplikaci.

Podrobnější dokumentaci najdete v tématu https://docs.microsoft.com/graph/api/resources/application.

az ad app create --display-name
                 [--app-roles]
                 [--enable-access-token-issuance {false, true}]
                 [--enable-id-token-issuance {false, true}]
                 [--end-date]
                 [--identifier-uris]
                 [--is-fallback-public-client {false, true}]
                 [--key-display-name]
                 [--key-type {AsymmetricX509Cert, Password, Symmetric}]
                 [--key-usage {Sign, Verify}]
                 [--key-value]
                 [--optional-claims]
                 [--public-client-redirect-uris]
                 [--required-resource-accesses]
                 [--sign-in-audience {AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount}]
                 [--start-date]
                 [--web-home-page-url]
                 [--web-redirect-uris]

Příklady

Vytvořte aplikaci.

az ad app create --display-name mytestapp

Vytvoření aplikace, která se může vrátit k veřejnému klientovi s delegovaným oprávněním Microsoft Graph User.Read

az ad app create --display-name my-public --is-fallback-public-client --required-resource-accesses @manifest.json
("manifest.json" contains the following content)
[{
    "resourceAppId": "00000003-0000-0000-c000-000000000000",
    "resourceAccess": [
        {
            "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
            "type": "Scope"
        }
   ]
}]

Vytvoření aplikace s rolí

az ad app create --display-name mytestapp --identifier-uris https://mytestapp.websites.net --app-roles @manifest.json
("manifest.json" contains the following content)
[{
    "allowedMemberTypes": [
      "User"
    ],
    "description": "Approvers can mark documents as approved",
    "displayName": "Approver",
    "isEnabled": "true",
    "value": "approver"
}]

Vytvoření aplikace s volitelnými deklaracemi identity

az ad app create --display-name mytestapp --optional-claims @manifest.json
("manifest.json" contains the following content)
{
    "idToken": [
        {
            "name": "auth_time",
            "essential": false
        }
    ],
    "accessToken": [
        {
            "name": "ipaddr",
            "essential": false
        }
    ],
    "saml2Token": [
        {
            "name": "upn",
            "essential": false
        },
        {
            "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
            "source": "user",
            "essential": false
        }
    ]
}

Povinné parametry

--display-name

Zobrazovaný název aplikace.

Volitelné parametry

--app-roles

Kolekce rolí přiřazených k aplikaci. Při přiřazení rolí aplikace je možné tyto role přiřadit uživatelům, skupinám nebo instančním objektům přidruženým k jiným aplikacím. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--enable-access-token-issuance

Určuje, jestli tato webová aplikace může požádat o přístupový token pomocí implicitního toku OAuth 2.0.

přijímané hodnoty: false, true
--enable-id-token-issuance

Určuje, jestli tato webová aplikace může požádat o token ID pomocí implicitního toku OAuth 2.0.

přijímané hodnoty: false, true
--end-date

Datum nebo datum a čas, po kterém vyprší platnost přihlašovacích údajů (např. 2017-12-31T11:59:59+00:00 nebo 2017-12-31). Výchozí hodnota je jeden rok po aktuálním čase.

--identifier-uris

Hodnoty oddělené mezerami. Tato hodnota se také označuje jako identifikátor URI ID aplikace, která se nastavuje, když se aplikace používá jako aplikace prostředků. IdentifikátorUris funguje jako předpona pro obory, na které budete odkazovat v kódu rozhraní API, a musí být globálně jedinečný. Můžete použít zadanou výchozí hodnotu, která je ve formuláři api://, nebo zadat čitelnější identifikátor URI, například https://contoso.com/api.

--is-fallback-public-client

Určuje záložní typ aplikace jako veřejný klient, například nainstalovanou aplikaci spuštěnou na mobilním zařízení. Výchozí hodnota je false, což znamená, že záložní typ aplikace je důvěrný klient, jako je webová aplikace.

přijímané hodnoty: false, true
--key-display-name

Popisný název klíče

--key-type

Typ přihlašovacích údajů klíče přidružených k aplikaci.

přijímané hodnoty: AsymmetricX509Cert, Password, Symmetric
výchozí hodnota: AsymmetricX509Cert
--key-usage

Použití přihlašovacích údajů klíče přidružených k aplikaci.

přijímané hodnoty: Sign, Verify
výchozí hodnota: Verify
--key-value

Hodnota přihlašovacích údajů klíče přidružených k aplikaci.

--optional-claims

Vývojáři aplikací můžou ve svých aplikacích Microsoft Entra nakonfigurovat volitelné deklarace identity, aby určili deklarace identity, které se posílají do aplikace službou tokenů zabezpečení Microsoftu. Další informace najdete na webu https://docs.microsoft.com/azure/active-directory/develop/active-directory-optional-claims. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--public-client-redirect-uris

Hodnoty oddělené mezerami. Určuje adresy URL, ve kterých se posílají tokeny uživatelů pro přihlášení, nebo identifikátory URI přesměrování, kde se odesílají autorizační kódy OAuth 2.0 a přístupové tokeny.

--required-resource-accesses

Určuje prostředky, ke kterým má aplikace přístup. Tato vlastnost také určuje sadu delegovaných oprávnění a rolí aplikace, které potřebuje pro každý z těchto prostředků. Tato konfigurace přístupu k požadovaným prostředkům řídí prostředí souhlasu. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--sign-in-audience

Určuje účty Microsoft, které jsou podporovány pro aktuální aplikaci.

přijímané hodnoty: AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount
--start-date

Datum nebo datum a čas, kdy se přihlašovací údaje stanou platnými (např. 2017-01-01T01:00:00+00:00 nebo 2017-01-01).) Výchozí hodnota je aktuální čas.

--web-home-page-url

Domovská stránka nebo cílová stránka aplikace

--web-redirect-uris

Hodnoty oddělené mezerami. Určuje adresy URL, ve kterých se posílají tokeny uživatelů pro přihlášení, nebo identifikátory URI přesměrování, kde se odesílají autorizační kódy OAuth 2.0 a přístupové tokeny.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ad app delete

Upravit

Odstraňte aplikaci.

az ad app delete --id

Příklady

Odstraňte aplikaci. (automaticky vygenerováno)

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

Povinné parametry

--id

Identifikátor URI, ID aplikace nebo ID objektu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ad app list

Upravit

Zobrazení seznamu aplikací

Pro nízkou latenci se ve výchozím nastavení vrátí pouze prvních 100, pokud nezadáte argumenty filtru nebo použijete "---all".

az ad app list [--all]
               [--app-id]
               [--display-name]
               [--filter]
               [--identifier-uri]
               [--show-mine]

Volitelné parametry

--all

Vypsat všechny entity, očekávat dlouhou prodlevu, pokud je ve velké organizaci.

--app-id

ID aplikace.

--display-name

Zobrazovaný název aplikace.

--filter

Filtr OData, například --filter "displayname eq 'test' and servicePrincipalType eq 'Application'.

--identifier-uri

Identifikátor aplikace grafu musí být ve formátu URI.

--show-mine

Výpis entit vlastněných aktuálním uživatelem

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ad app show

Upravit

Získejte podrobnosti o aplikaci.

az ad app show --id

Příklady

Získejte podrobnosti o aplikaci pomocí appId.

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

Získejte podrobnosti o aplikaci s ID.

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

Získejte podrobnosti o aplikaci s identifikátorem URI.

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

Povinné parametry

--id

Identifikátor URI, ID aplikace nebo ID objektu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az ad app update

Upravit

Aktualizujte aplikaci.

az ad app update --id
                 [--add]
                 [--app-roles]
                 [--display-name]
                 [--enable-access-token-issuance {false, true}]
                 [--enable-id-token-issuance {false, true}]
                 [--end-date]
                 [--force-string]
                 [--identifier-uris]
                 [--is-fallback-public-client {false, true}]
                 [--key-display-name]
                 [--key-type {AsymmetricX509Cert, Password, Symmetric}]
                 [--key-usage {Sign, Verify}]
                 [--key-value]
                 [--optional-claims]
                 [--public-client-redirect-uris]
                 [--remove]
                 [--required-resource-accesses]
                 [--set]
                 [--sign-in-audience {AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount}]
                 [--start-date]
                 [--web-home-page-url]
                 [--web-redirect-uris]

Příklady

Aktualizace aplikace pomocí delegovaného oprávnění Microsoft Graph User.Read

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --required-resource-accesses @manifest.json
("manifest.json" contains the following content)
[{
    "resourceAppId": "00000003-0000-0000-c000-000000000000",
    "resourceAccess": [
        {
            "id": "e1fe6dd8-ba31-4d61-89e7-88639da4683d",
            "type": "Scope"
        }
   ]
}]

deklarace role aplikace

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --app-roles @manifest.json
("manifest.json" contains the following content)
[{
    "allowedMemberTypes": [
      "User"
    ],
    "description": "Approvers can mark documents as approved",
    "displayName": "Approver",
    "isEnabled": "true",
    "value": "approver"
}]

Aktualizace volitelných deklarací identity

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --optional-claims @manifest.json
("manifest.json" contains the following content)
{
    "idToken": [
        {
            "name": "auth_time",
            "essential": false
        }
    ],
    "accessToken": [
        {
            "name": "ipaddr",
            "essential": false
        }
    ],
    "saml2Token": [
        {
            "name": "upn",
            "essential": false
        },
        {
            "name": "extension_ab603c56068041afb2f6832e2a17e237_skypeId",
            "source": "user",
            "essential": false
        }
    ]
}

Aktualizace deklarací členství ve skupině aplikace na "Vše"

az ad app update --id e042ec79-34cd-498f-9d9f-123456781234 --set groupMembershipClaims=All

Povinné parametry

--id

Identifikátor URI, ID aplikace nebo ID objektu.

Volitelné parametry

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

výchozí hodnota: []
--app-roles

Kolekce rolí přiřazených k aplikaci. Při přiřazení rolí aplikace je možné tyto role přiřadit uživatelům, skupinám nebo instančním objektům přidruženým k jiným aplikacím. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--display-name

Zobrazovaný název aplikace.

--enable-access-token-issuance

Určuje, jestli tato webová aplikace může požádat o přístupový token pomocí implicitního toku OAuth 2.0.

přijímané hodnoty: false, true
--enable-id-token-issuance

Určuje, jestli tato webová aplikace může požádat o token ID pomocí implicitního toku OAuth 2.0.

přijímané hodnoty: false, true
--end-date

Datum nebo datum a čas, po kterém vyprší platnost přihlašovacích údajů (např. 2017-12-31T11:59:59+00:00 nebo 2017-12-31). Výchozí hodnota je jeden rok po aktuálním čase.

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

výchozí hodnota: False
--identifier-uris

Hodnoty oddělené mezerami. Tato hodnota se také označuje jako identifikátor URI ID aplikace, která se nastavuje, když se aplikace používá jako aplikace prostředků. IdentifikátorUris funguje jako předpona pro obory, na které budete odkazovat v kódu rozhraní API, a musí být globálně jedinečný. Můžete použít zadanou výchozí hodnotu, která je ve formuláři api://, nebo zadat čitelnější identifikátor URI, například https://contoso.com/api.

--is-fallback-public-client

Určuje záložní typ aplikace jako veřejný klient, například nainstalovanou aplikaci spuštěnou na mobilním zařízení. Výchozí hodnota je false, což znamená, že záložní typ aplikace je důvěrný klient, jako je webová aplikace.

přijímané hodnoty: false, true
--key-display-name

Popisný název klíče

--key-type

Typ přihlašovacích údajů klíče přidružených k aplikaci.

přijímané hodnoty: AsymmetricX509Cert, Password, Symmetric
výchozí hodnota: AsymmetricX509Cert
--key-usage

Použití přihlašovacích údajů klíče přidružených k aplikaci.

přijímané hodnoty: Sign, Verify
výchozí hodnota: Verify
--key-value

Hodnota přihlašovacích údajů klíče přidružených k aplikaci.

--optional-claims

Vývojáři aplikací můžou ve svých aplikacích Microsoft Entra nakonfigurovat volitelné deklarace identity, aby určili deklarace identity, které se posílají do aplikace službou tokenů zabezpečení Microsoftu. Další informace najdete na webu https://docs.microsoft.com/azure/active-directory/develop/active-directory-optional-claims. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--public-client-redirect-uris

Hodnoty oddělené mezerami. Určuje adresy URL, ve kterých se posílají tokeny uživatelů pro přihlášení, nebo identifikátory URI přesměrování, kde se odesílají autorizační kódy OAuth 2.0 a přístupové tokeny.

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

výchozí hodnota: []
--required-resource-accesses

Určuje prostředky, ke kterým má aplikace přístup. Tato vlastnost také určuje sadu delegovaných oprávnění a rolí aplikace, které potřebuje pro každý z těchto prostředků. Tato konfigurace přístupu k požadovaným prostředkům řídí prostředí souhlasu. Měla by to být cesta k souboru JSON nebo řetězec JSON v řádku. Podrobnosti najdete v příkladech.

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

výchozí hodnota: []
--sign-in-audience

Určuje účty Microsoft, které jsou podporovány pro aktuální aplikaci.

přijímané hodnoty: AzureADMultipleOrgs, AzureADMyOrg, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount
--start-date

Datum nebo datum a čas, kdy se přihlašovací údaje stanou platnými (např. 2017-01-01T01:00:00+00:00 nebo 2017-01-01).) Výchozí hodnota je aktuální čas.

--web-home-page-url

Domovská stránka nebo cílová stránka aplikace

--web-redirect-uris

Hodnoty oddělené mezerami. Určuje adresy URL, ve kterých se posílají tokeny uživatelů pro přihlášení, nebo identifikátory URI přesměrování, kde se odesílají autorizační kódy OAuth 2.0 a přístupové tokeny.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

přijímané hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
výchozí hodnota: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.