Muokkaa

Jaa


Get-AzureADMSApplication

Retrieves the list of applications within the organization.

Syntax

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

Description

Retrieves the list of applications within the organization. With an ObjectId argument, it can retrieve the properties of the application object associated with the ObjectId.

Examples

Example 1: Get an application by display name

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                     : 00001111-aaaa-2222-bbbb-3333cccc4444
          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
          }

          }

This command gets an application by its display name.

Example 2: Get an application by ID

PS C:\>Get-AzureADMSApplication -Filter "AppId eq '11112222-bbbb-3333-cccc-4444dddd5555'"

This command gets an application by its ID.

Output:

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                     : 00001111-aaaa-2222-bbbb-3333cccc4444
        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
        }

        }

Example 3: Retrieve an application by identifierUris

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

Example 4: Get an application by object ID

PS C:\>Get-AzureADMSApplication -ObjectId aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

This command gets an application by its object ID.

Output:

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                     : 22223333-cccc-4444-dddd-5555eeee6666
        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
        }

        }

Example 5: Get the first 2 applications

PS C:\>Get-AzureADMSApplication -Top 2

This command gets the first 2 applications

Output:

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                     : 33334444-dddd-5555-eeee-6666ffff7777
        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                     : 44445555-eeee-6666-ffff-7777aaaa8888
        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
        }

        }

Example 6: Retrieve a list of all applications

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

Example 5: Retrieve a list of all applications which have a display name that contains "asdfl"

PS C:\>Get-AzureADMSApplication -SearchString asdfl

This command gets a list of applications which have the specified display name

Output:

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                     : 55556666-ffff-7777-aaaa-8888bbbb9999
        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
        }

        }

Parameters

-All

If true, return all applications. If false, return the number of objects specified by the Top parameter

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

Specifies an oData v3.0 filter statement. This parameter controls which objects are returned.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

Specifies the ID of an application in the Microsoft Entra ID.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

Retrieve only those applications that satisfy the -SearchString value

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

Specifies the maximum number of records to return.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Inputs

bool

int

string

Outputs

Microsoft.Open.MSGraph.Model.MsApplication

Notes

See the migration guide for Get-AzureADMSApplication to the Microsoft Graph PowerShell.