Compartilhar via

Get-AzureADMSApplication

  • Referência
Módulo:
AzureAD

Recupera a lista de aplicativos dentro da organização.

Sintaxe

Get-AzureADMSApplication
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSApplication
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSApplication
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

Recupera a lista de aplicativos dentro da organização. Com um argumento ObjectId, ele pode recuperar as propriedades do objeto de aplicativo associado à ObjectId.

Exemplos

Exemplo 1: Obter um aplicativo por nome de exibição

PS C:\>Get-AzureADMSApplication -Filter "DisplayName eq 'My App'"

          Id                        : ba4a97a7-3815-4752-bf4c-f1c0cccfff6a
          OdataType                 :
          Api                       : class ApiApplication {
          AcceptMappedClaims:
          KnownClientApplications:
          PreAuthorizedApplications:
          RequestedAccessTokenVersion: 2
          Oauth2PermissionScopes:
          System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PermissionScope]
          }

          AppId                     : 807dd73f-8451-4cfa-b3bc-52ac3fd95330
          AppRoles                  : {}
          IsDeviceOnlyAuthSupported :
          IsFallbackPublicClient    :
          IdentifierUris            : {}
          DeletedDateTime           :
          DisplayName               : My App
          Info                      : class InformationalUrl {
          TermsOfServiceUrl:
          MarketingUrl:
          PrivacyStatementUrl:
          SupportUrl:
          LogoUrl:
          }

          KeyCredentials            : {}
          OptionalClaims            :
          ParentalControlSettings   : class ParentalControlSettings {
          CountriesBlockedForMinors: System.Collections.Generic.List`1[System.String]
          LegalAgeGroupRule: Allow
          }

          PasswordCredentials       : {}
          PublicClientApplication   :
          RequiredResourceAccess    : {}
          SignInAudience            : AzureADandPersonalMicrosoftAccount
          Tags                      : {}
          TokenEncryptionKeyId      :
          Web                       : class WebApplication {
          LogoutUrl:
          Oauth2AllowImplicitFlow:
          RedirectUris: System.Collections.Generic.List`1[System.String]
          ImplicitGrantSettings: class ImplicitGrantSettings {
          EnableIdTokenIssuance: False
          EnableAccessTokenIssuance: False
          }

          }

Esse comando obtém um aplicativo pelo nome de exibição.

Exemplo 2: Obter um aplicativo por ID

PS C:\>Get-AzureADMSApplication -Filter "AppId eq 'ed192e92-84d4-4baf-997d-1e190a81f28e'"

Esse comando obtém um aplicativo por sua ID.

Saída:

Id: ba4a97a7-3815-4752-bf4c-f1c0cccfff6a OdataType : Api : classe ApiApplication { AcceptMappedClaims: KnownClientApplications: PreAuthorizedApplications: RequestedAccessTokenVersion: 2 Oauth2PermissionScopes: System.Collections.Generic.List'1[Microsoft.Open.MSGraph.Model.PermissionScope] }

        AppId                     : 807dd73f-8451-4cfa-b3bc-52ac3fd95330
        AppRoles                  : {}
        IsDeviceOnlyAuthSupported :
        IsFallbackPublicClient    :
        IdentifierUris            : {}
        DeletedDateTime           :
        DisplayName               : My App
        Info                      : class InformationalUrl {
        TermsOfServiceUrl:
        MarketingUrl:
        PrivacyStatementUrl:
        SupportUrl:
        LogoUrl:
        }

        KeyCredentials            : {}
        OptionalClaims            :
        ParentalControlSettings   : class ParentalControlSettings {
        CountriesBlockedForMinors: System.Collections.Generic.List\`1\[System.String\]
        LegalAgeGroupRule: Allow
        }

        PasswordCredentials       : {}
        PublicClientApplication   :
        RequiredResourceAccess    : {}
        SignInAudience            : AzureADandPersonalMicrosoftAccount
        Tags                      : {}
        TokenEncryptionKeyId      :
        Web                       : class WebApplication {
        LogoutUrl:
        Oauth2AllowImplicitFlow:
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        ImplicitGrantSettings: class ImplicitGrantSettings {
        EnableIdTokenIssuance: False
        EnableAccessTokenIssuance: False
        }

        }

Exemplo 3: recuperar um aplicativo por identifierUris

Get-AzureADMSApplication -Filter "identifierUris/any(uri:uri eq 'http://wingtips.wingtiptoysonline.com')"

Exemplo 4: Obter um aplicativo por ID de objeto

PS C:\>Get-AzureADMSApplication -ObjectId ffe886bc-e978-4002-829e-cf5b1e83d56a

Esse comando obtém um aplicativo por sua ID de objeto.

Saída:

Id: f8bbcbe4-df80-4a6b-80c5-926e28e41407 OdataType : AddIns : {} Api : class ApiApplication { AcceptMappedClaims: KnownClientApplications: PreAuthorizedApplications: RequestedAccessTokenVersion: Oauth2PermissionScopes: System.Collections.Generic.List'1[Microsoft.Open.MSGraph.Model.PermissionScope]

        AppId                     : 18f78c92-365c-4fa0-9b6f-7e06fff27ffe
        ApplicationTemplateId     :
        AppRoles                  : {}
        GroupMembershipClaims     :
        IsDeviceOnlyAuthSupported :
        IsFallbackPublicClient    :
        IdentifierUris            : {}
        CreatedDateTime           :
        DeletedDateTime           :
        DisplayName               : my app
        Info                      : class InformationalUrl {
        TermsOfServiceUrl:
        MarketingUrl:
        PrivacyStatementUrl:
        SupportUrl:
        LogoUrl:
        }

        KeyCredentials            : {}
        OptionalClaims            :
        ParentalControlSettings   : class ParentalControlSettings {
        CountriesBlockedForMinors: System.Collections.Generic.List\`1\[System.String\]
        LegalAgeGroupRule: Allow
        }

        PasswordCredentials       : {}
        PublicClient              : class PublicClientApplication {
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        }

        PublisherDomain           :
        RequiredResourceAccess    : {}
        SignInAudience            : AzureADMyOrg
        Tags                      : {}
        TokenEncryptionKeyId      :
        Web                       : class WebApplication {
        HomePageUrl:
        LogoutUrl:
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        ImplicitGrantSettings: class ImplicitGrantSettings {
        EnableIdTokenIssuance: True
        EnableAccessTokenIssuance: False
        }

        }

Exemplo 5: Obter os dois primeiros aplicativos

PS C:\>Get-AzureADMSApplication -Top 2

Esse comando obtém os dois primeiros aplicativos

Saída:

Id: 121ce3aa-64cb-44f2-99e8-deb705caeddd OdataType : AddIns : {} Api : class ApiApplication { AcceptMappedClaims: KnownClientApplications: PreAuthorizedApplications: RequestedAccessTokenVersion: 2 Oauth2PermissionScopes: System.Collections.Generic.List'1[Microsoft.Open.MSGraph.Model.PermissionScope]

        AppId                     : a1293e4b-97ae-4f58-9eeb-d0ba5b4b821a
        ApplicationTemplateId     :
        AppRoles                  : {}
        GroupMembershipClaims     :
        IsDeviceOnlyAuthSupported :
        IsFallbackPublicClient    :
        IdentifierUris            : {}
        CreatedDateTime           :
        DeletedDateTime           :
        DisplayName               : My App
        Info                      : class InformationalUrl {
        TermsOfServiceUrl:
        MarketingUrl:
        PrivacyStatementUrl:
        SupportUrl:
        LogoUrl:
        }

        KeyCredentials            : {}
        OptionalClaims            :
        ParentalControlSettings   : class ParentalControlSettings {
        CountriesBlockedForMinors: System.Collections.Generic.List\`1\[System.String\]
        LegalAgeGroupRule: Allow
        }

        PasswordCredentials       : {}
        PublicClient              : class PublicClientApplication {
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        }

        PublisherDomain           :
        RequiredResourceAccess    : {}
        SignInAudience            : AzureADandPersonalMicrosoftAccount
        Tags                      : {}
        TokenEncryptionKeyId      :
        Web                       : class WebApplication {
        HomePageUrl:
        LogoutUrl:
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        ImplicitGrantSettings: class ImplicitGrantSettings {
        EnableIdTokenIssuance: False
        EnableAccessTokenIssuance: False
        }

        }


        Id                        : 14a3f1ac-46a7-4d00-b1ca-0b2b84f033c2
        OdataType                 :
        AddIns                    : {}
        Api                       : class ApiApplication {
        AcceptMappedClaims:
        KnownClientApplications:
        PreAuthorizedApplications:
        RequestedAccessTokenVersion: 2
        Oauth2PermissionScopes:
        System.Collections.Generic.List\`1\[Microsoft.Open.MSGraph.Model.PermissionScope\]

        AppId                     : 51546bbc-4233-42d3-a08e-c73a370f5d41
        ApplicationTemplateId     :
        AppRoles                  : {}
        GroupMembershipClaims     :
        IsDeviceOnlyAuthSupported :
        IsFallbackPublicClient    :
        IdentifierUris            : {}
        CreatedDateTime           :
        DeletedDateTime           :
        DisplayName               : My App
        Info                      : class InformationalUrl {
        TermsOfServiceUrl:
        MarketingUrl:
        PrivacyStatementUrl:
        SupportUrl:
        LogoUrl:
        }

        KeyCredentials            : {}
        OptionalClaims            :
        ParentalControlSettings   : class ParentalControlSettings {
        CountriesBlockedForMinors: System.Collections.Generic.List\`1\[System.String\]
        LegalAgeGroupRule: Allow
        }

        PasswordCredentials       : {}
        PublicClient              : class PublicClientApplication {
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        }

        PublisherDomain           :
        RequiredResourceAccess    : {}
        SignInAudience            : AzureADandPersonalMicrosoftAccount
        Tags                      : {}
        TokenEncryptionKeyId      :
        Web                       : class WebApplication {
        HomePageUrl:
        LogoutUrl:
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        ImplicitGrantSettings: class ImplicitGrantSettings {
        EnableIdTokenIssuance: False
        EnableAccessTokenIssuance: False
        }

        }

Exemplo 6: recuperar uma lista de todos os aplicativos

PS C:\>Get-AzureADMSApplication -All $true

Exemplo 5: recuperar uma lista de todos os aplicativos que têm um nome de exibição que contém "asdfl"

PS C:\>Get-AzureADMSApplication -SearchString asdfl

Esse comando obtém uma lista de aplicativos que têm o nome de exibição especificado

Saída:

Id: 88da75d4-2cba-4c47-9a15-80a983228ad4 OdataType : AddIns : {} Api : class ApiApplication { AcceptMappedClaims: KnownClientApplications: PreAuthorizedApplications: RequestedAccessTokenVersion: 2 Oauth2PermissionScopes: System.Collections.Generic.List'1[Microsoft.Open.MSGraph.Model.PermissionScope]

        AppId                     : 2cffc854-bbcf-404a-8bba-70d043534129
        ApplicationTemplateId     :
        AppRoles                  : {}
        GroupMembershipClaims     :
        IsDeviceOnlyAuthSupported :
        IsFallbackPublicClient    :
        IdentifierUris            : {}
        CreatedDateTime           : 10/24/2019 6:27:25 AM
        DeletedDateTime           :
        DisplayName               : asdflkj
        Info                      : class InformationalUrl {
        TermsOfServiceUrl:
        MarketingUrl:
        PrivacyStatementUrl:
        SupportUrl:
        LogoUrl:
        }

        KeyCredentials            : {}
        OptionalClaims            :
        ParentalControlSettings   : class ParentalControlSettings {
        CountriesBlockedForMinors: System.Collections.Generic.List\`1\[System.String\]
        LegalAgeGroupRule: Allow
        }

        PasswordCredentials       : {}
        PublicClient              : class PublicClientApplication {
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        }

        PublisherDomain           :
        RequiredResourceAccess    : {}
        SignInAudience            : AzureADandPersonalMicrosoftAccount
        Tags                      : {}
        TokenEncryptionKeyId      :
        Web                       : class WebApplication {
        HomePageUrl:
        LogoutUrl:
        RedirectUris: System.Collections.Generic.List\`1\[System.String\]
        ImplicitGrantSettings: class ImplicitGrantSettings {
        EnableIdTokenIssuance: False
        EnableAccessTokenIssuance: False
        }

        }

Parâmetros

-All

Se for true, retorne todos os aplicativos. Se false, retorne o número de objetos especificados pelo parâmetro Top

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Filter

Especifica uma instrução de filtro oData v3.0. Esse parâmetro controla quais objetos são retornados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ObjectId

Especifica a ID de um aplicativo na ID do Microsoft Entra.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SearchString

Recuperar somente os aplicativos que atendem ao valor -SearchString

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Top

Especifica o número máximo de registros a serem retornados.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

bool

int

string

Saídas

Microsoft.Open.MSGraph.Model.MsApplication

Observações

Consulte o guia de migração para Get-AzureADMSApplication para o Microsoft Graph PowerShell.