az ad app

Správa aplikací Microsoft Entra

Příkazy

Name	Description	Typ	Stav
az ad app create	Vytvořte aplikaci.	Core	GA
az ad app credential	Umožňuje spravovat heslo aplikace nebo přihlašovací údaje certifikátu.	Core	GA
az ad app credential delete	Odstraňte heslo nebo přihlašovací údaje certifikátu aplikace.	Core	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.)	Core	GA
az ad app credential reset	Resetujte heslo aplikace nebo přihlašovací údaje certifikátu.	Core	GA
az ad app delete	Odstraňte aplikaci.	Core	GA
az ad app federated-credential	Správa přihlašovacích údajů federované identity aplikace	Core	GA
az ad app federated-credential create	Vytvořte přihlašovací údaje federované identity aplikace.	Core	GA
az ad app federated-credential delete	Odstraňte přihlašovací údaje federované identity aplikace.	Core	GA
az ad app federated-credential list	Výpis přihlašovacích údajů federované identity aplikace	Core	GA
az ad app federated-credential show	Zobrazení přihlašovacích údajů federované identity aplikace	Core	GA
az ad app federated-credential update	Aktualizujte přihlašovací údaje federované identity aplikace.	Core	GA
az ad app list	Zobrazení seznamu aplikací	Core	GA
az ad app owner	Správa vlastníků aplikací	Core	GA
az ad app owner add	Přidejte vlastníka aplikace.	Core	GA
az ad app owner list	Vypsat vlastníky aplikací	Core	GA
az ad app owner remove	Odeberte vlastníka aplikace.	Core	GA
az ad app permission	Umožňuje spravovat oprávnění OAuth2 aplikace.	Core	GA
az ad app permission add	Přidejte oprávnění rozhraní API.	Core	GA
az ad app permission admin-consent	Udělte aplikaci & delegovaná oprávnění prostřednictvím souhlasu správce.	Core	GA
az ad app permission delete	Odeberte oprávnění rozhraní API.	Core	GA
az ad app permission grant	Udělte aplikaci delegovaná oprávnění rozhraní API.	Core	GA
az ad app permission list	Výpis oprávnění rozhraní API, která aplikace požadovala.	Core	GA
az ad app permission list-grants	Výpis udělení oprávnění Oauth2	Core	GA
az ad app show	Získejte podrobnosti o aplikaci.	Core	GA
az ad app update	Aktualizujte aplikaci.	Core	GA

az ad app create

Upravit

Vytvořte aplikaci.

Podrobnější dokumentaci najdete v tématu https://learn.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]
                 [--requested-access-token-version]
                 [--required-resource-accesses]
                 [--service-management-reference]
                 [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--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.

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--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.

Vlastnost	Hodnota
Skupina parametrů:	web Arguments
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	web Arguments
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--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 výchozí hodnotu, která je ve formuláři api://<application-client-id>, 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.

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

--key-display-name

Popisný název klíče

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--key-type

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments
Default value:	AsymmetricX509Cert
Přípustné hodnoty:	AsymmetricX509Cert, Password, Symmetric

--key-usage

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments
Default value:	Verify
Přípustné hodnoty:	Sign, Verify

--key-value

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--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 v tématu https://learn.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.

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--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.

Vlastnost	Hodnota
Skupina parametrů:	publicClient Arguments

--requested-access-token-version

Určuje verzi přístupového tokenu očekávanou tímto prostředkem. Tím se změní verze a formát JWT vytvořené nezávisle na koncovém bodu nebo klientovi použitém k vyžádání přístupového tokenu.

Vlastnost	Hodnota
Skupina parametrů:	api Arguments

--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.

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--service-management-reference

Odkazuje na kontaktní informace aplikace nebo služby z databáze služby nebo správy prostředků.

--sign-in-audience

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

Vlastnost	Hodnota
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--web-home-page-url

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

Vlastnost	Hodnota
Skupina parametrů:	web Arguments

--web-redirect-uris

Vlastnost	Hodnota
Skupina parametrů:	web Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

az ad app delete

Upravit

Odstraňte aplikaci.

az ad app delete --id

Příklady

Odstraňte aplikaci. (autogenerated)

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í.

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--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í.

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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í.

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

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]
                 [--requested-access-token-version]
                 [--required-resource-accesses]
                 [--service-management-reference]
                 [--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

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--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>.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--app-roles

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--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.

Vlastnost	Hodnota
Skupina parametrů:	web Arguments
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	web Arguments
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--force-string

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

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	False

--identifier-uris

--is-fallback-public-client

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

--key-display-name

Popisný název klíče

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--key-type

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments
Default value:	AsymmetricX509Cert
Přípustné hodnoty:	AsymmetricX509Cert, Password, Symmetric

--key-usage

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments
Default value:	Verify
Přípustné hodnoty:	Sign, Verify

--key-value

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

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--optional-claims

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--public-client-redirect-uris

Vlastnost	Hodnota
Skupina parametrů:	publicClient Arguments

--remove

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

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--requested-access-token-version

Vlastnost	Hodnota
Skupina parametrů:	api Arguments

--required-resource-accesses

Vlastnost	Hodnota
Skupina parametrů:	JSON property Arguments

--service-management-reference

Odkazuje na kontaktní informace aplikace nebo služby z databáze služby nebo správy prostředků.

--set

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

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--sign-in-audience

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

Vlastnost	Hodnota
Přípustné 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.

Vlastnost	Hodnota
Skupina parametrů:	keyCredential Arguments

--web-home-page-url

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

Vlastnost	Hodnota
Skupina parametrů:	web Arguments

--web-redirect-uris

Vlastnost	Hodnota
Skupina parametrů:	web Arguments

Globální parametry

--debug

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

Vlastnost	Hodnota
Default value:	False

--help -h

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

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

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

Vlastnost	Hodnota
Default value:	False

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

az ad app

Příkazy

az ad app create

Příklady

Povinné parametry

Volitelné parametry

az ad app delete

Příklady

Povinné parametry

az ad app list

Volitelné parametry

az ad app show

Příklady

Povinné parametry

az ad app update

Příklady

Povinné parametry

Volitelné parametry

Váš názor