Get-CMApplication
Get an application.
Syntax
Get-CMApplication
[-Fast]
[[-Name] <String>]
[-ShowHidden]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMApplication
[-Fast]
-Id <Int32>
[-ShowHidden]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMApplication
[-Fast]
-InputObject <IResultObject>
[-ShowHidden]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMApplication
[-Fast]
-ModelName <String>
[-ShowHidden]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Description
Use this cmdlet to get a Configuration Manager application. A Configuration Manager application defines the metadata about app. An application has one or more deployment types. These deployment types include the installation files and information that are required to install software on devices. A deployment type also has rules, such as detection methods and requirements. These rules specify when and how the client installs the software.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
Examples
Example 1: Get an application by name
This command gets the application object named Application1.
Get-CMApplication -Name "Application1"
Example 2: Get the application for a deployment type
The first command gets the deployment type object named DT2 for the application named Application1 and stores the object in the $DeploymentType variable. The second command uses the pipeline operator to pass the deployment type stored in $DeploymentType to Get-CMApplication, which gets the application for the deployment type.
$DeploymentType = Get-CMDeploymentType -DeploymentTypeName "DT2" -ApplicationName "Application1"
$DeploymentType | Get-CMApplication
Parameters
-DisableWildcardHandling
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Fast
Add this parameter to not automatically refresh lazy properties. Lazy properties contain values that are relatively inefficient to retrieve. Getting these properties can cause additional network traffic and decrease cmdlet performance.
If you don't use this parameter, the cmdlet displays a warning. To disable this warning, set $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Specify the CI_ID of an application to get. For example, 136846
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Specify a deployment type object to get the associated application. To get this object, use the Get-CMDeploymentType cmdlet.
Type: | IResultObject |
Aliases: | DeploymentType |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ModelName
Specify the ModelID of an application to get. For example, 136846
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specify the name of an application to get.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowHidden
Add this parameter to show hidden applications. A hidden application has the IsHidden property set to $true
. A hidden app doesn't display in the Configuration Manager console, and it only returns with this cmdlet when you specify this parameter.
To hide an application, use the following commands:
$app = Get-CMApplication -Name "test app" $app.IsHidden = $true $app.Put()
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Outputs
IResultObject[]
IResultObject
IResultObject
Notes
For more information on these return object and their properties, see the following articles: