Get-CMApplication

  • Référence
Module:
ConfigurationManager

Obtenir une application.

Syntaxe

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

Utilisez cette applet de commande pour obtenir une application Configuration Manager. Une application Configuration Manager définit les métadonnées relatives à l’application. Une application a un ou plusieurs types de déploiement. Ces types de déploiement incluent les fichiers d’installation et les informations nécessaires à l’installation du logiciel sur les appareils. Un type de déploiement a également des règles, telles que les méthodes de détection et les exigences. Ces règles spécifient quand et comment le client installe le logiciel.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir une application par son nom

Cette commande obtient l’objet d’application nommé Application1.

Get-CMApplication -Name "Application1"

Exemple 2 : Obtenir l’application pour un type de déploiement

La première commande obtient l’objet de type de déploiement nommé DT2 pour l’application nommée Application1 et stocke l’objet dans la variable $DeploymentType . La deuxième commande utilise l’opérateur de pipeline pour passer le type de déploiement stocké dans $DeploymentType à Get-CMApplication, qui obtient l’application pour le type de déploiement.

$DeploymentType = Get-CMDeploymentType -DeploymentTypeName "DT2" -ApplicationName "Application1"
$DeploymentType | Get-CMApplication

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Fast

Ajoutez ce paramètre pour ne pas actualiser automatiquement les propriétés différées. Les propriétés différées contiennent des valeurs qui sont relativement inefficaces à récupérer. L’obtention de ces propriétés peut entraîner un trafic réseau supplémentaire et diminuer les performances des applets de commande.

Si vous n’utilisez pas ce paramètre, l’applet de commande affiche un avertissement. Pour désactiver cet avertissement, définissez $CMPSSuppressFastNotUsedCheck = $true.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez le CI_ID d’une application à obtenir. Par exemple : 136846.

Type:Int32
Alias:CIId, CI_ID
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet de type de déploiement pour obtenir l’application associée. Pour obtenir cet objet, utilisez l’applet de commande Get-CMDeploymentType .

Type:IResultObject
Alias:DeploymentType
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ModelName

Spécifiez le ModelID d’une application à obtenir. Par exemple : 136846.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom d’une application à obtenir.

Type:String
Alias:LocalizedDisplayName, ApplicationName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-ShowHidden

Ajoutez ce paramètre pour afficher les applications masquées. Une application masquée a la propriété IsHidden définie sur $true. Une application masquée ne s’affiche pas dans la console Configuration Manager, et elle retourne uniquement avec cette applet de commande lorsque vous spécifiez ce paramètre.

Pour masquer une application, utilisez les commandes suivantes :

$app = Get-CMApplication -Name « test app » $app. IsHidden = $true $app. Put()

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject

IResultObject

Notes

Pour plus d’informations sur ces objets de retour et leurs propriétés, consultez les articles suivants :