Изменить

Поделиться через


Get-EntraApplicationTemplate

Retrieve application templates from the Microsoft Entra gallery.

Syntax

Get-EntraApplicationTemplate
   [-Filter <String>]
   [-All]
   [-Top <Int32>]
   [-Property <String[]>]
   [<CommonParameters>]
Get-EntraApplicationTemplate
   -Id <String>
   [<CommonParameters>]

Description

The Get-EntraApplicationTemplate cmdlet retrieves application templates from the Microsoft Entra gallery.

Examples

Example 1. Gets a list of application template objects

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraApplicationTemplate -Select Id, DisplayName, Publisher, Categories

Id                                   Categories                                       DisplayName                                       Publisher
--                                   ----------                                       -----------                                       ---------
00000007-0000-0000-c000-000000000000 {crm, productivity, collaboration, businessMgmt} Dynamics CRM Online                              Microsoft Corporation
f447d87b-6e85-481d-90b2-bae3f42cb0f6 {businessMgmt, erp, finance}                     Xledger                                           Xledger Inc
5979191c-86e6-40f7-87ac-0913dddd1f61 {businessMgmt}                                   FigBytes                                          Figbytes
00000012-0000-0000-c000-000000000000 {}                                              Microsoft Azure Information Protection            Microsoft Corporation

This command lists all the application template objects.

Example 2: Get a list of application templates using All parameter

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraApplicationTemplate -Select Id, DisplayName, Publisher, Categories -All

Id                                   Categories                                       DisplayName                                       Publisher
--                                   ----------                                       -----------                                       ---------
00000007-0000-0000-c000-000000000000 {crm, productivity, collaboration, businessMgmt} Dynamics CRM Online                              Microsoft Corporation
f447d87b-6e85-481d-90b2-bae3f42cb0f6 {businessMgmt, erp, finance}                     Xledger                                           Xledger Inc
5979191c-86e6-40f7-87ac-0913dddd1f61 {businessMgmt}                                   FigBytes                                          Figbytes
00000012-0000-0000-c000-000000000000 {}                                              Microsoft Azure Information Protection            Microsoft Corporation

This cmdlet retrieves the list of application templates using All parameter.

Example 3: Get top two deleted application templates

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraApplicationTemplate -Top 2 -Select Id, DisplayName, Publisher, Categories

Id                                   Categories                                       DisplayName                                       Publisher
--                                   ----------                                       -----------                                       ---------
00000007-0000-0000-c000-000000000000 {crm, productivity, collaboration, businessMgmt} Dynamics CRM Online                              Microsoft Corporation
f447d87b-6e85-481d-90b2-bae3f42cb0f6 {businessMgmt, erp, finance}                     Xledger                                           Xledger Inc

This cmdlet retrieves the top two application templates. Limit can be used as an alias for Top.

Example 4: Get a list of application templates filtered by display name

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraApplicationTemplate -Filter "DisplayName eq 'Dynamics CRM Online'"

Id                                   Categories                                       DisplayName                                       Publisher
--                                   ----------                                       -----------                                       ---------
00000007-0000-0000-c000-000000000000 {crm, productivity, collaboration, businessMgmt} Dynamics CRM Online                              Microsoft Corporation

This example shows how to retrieve application templates with the specified display name.

Example 5. Get a specific application templates

Connect-Entra -Scopes 'Application.Read.All'
$applicationTemplate = Get-EntraApplicationTemplate -Filter "DisplayName eq 'Dynamics CRM Online'"
Get-EntraApplicationTemplate -Id $applicationTemplate.Id

Id                                   Categories                                      Description
--                                   ----------                                      -----------
aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb {businessMgmt, productivity, projectManagement} Cube is perfect for businesses

This command gets an application template object for the specific application template ID.

  • -Id Specifies the unique identifier of an application template.

Example 6: Get application templates in the CRM category

Connect-Entra -Scopes 'Application.Read.All'
Get-EntraApplicationTemplate -Filter "Categories/any(c:c eq 'crm')" -Select Id, DisplayName, Publisher, Categories

Id                                   Categories                                       DisplayName                                       Publisher
--                                   ----------                                       -----------                                       ---------
00000007-0000-0000-c000-000000000000 {crm, productivity, collaboration, businessMgmt} Dynamics CRM Online                              Microsoft Corporation

This example shows how to retrieve application templates in the CRM category.

Parameters

-All

List all pages.

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Specifies an OData v4.0 filter statement. This parameter controls which objects are returned.

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

-Id

The unique identifier of an application template.

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

-Property

Specifies properties to be returned.

Type:System.String[]
Aliases:Select
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Top

Specifies the maximum number of records to return.

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

Outputs

Microsoft.Online.Administration.ApplicationTemplate