Get-CMApplication

  • Referenz
Modul:
ConfigurationManager

Rufen Sie eine Anwendung ab.

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Configuration Manager-Anwendung abzurufen. Eine Configuration Manager-Anwendung definiert die Metadaten zur App. Eine Anwendung verfügt über einen oder mehrere Bereitstellungstypen. Diese Bereitstellungstypen enthalten die Installationsdateien und Informationen, die zum Installieren von Software auf Geräten erforderlich sind. Ein Bereitstellungstyp verfügt auch über Regeln, z. B. Erkennungsmethoden und Anforderungen. Diese Regeln geben an, wann und wie der Client die Software installiert.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen einer Anwendung anhand des Namens

Dieser Befehl ruft das Anwendungsobjekt mit dem Namen Application1 ab.

Get-CMApplication -Name "Application1"

Beispiel 2: Abrufen der Anwendung für einen Bereitstellungstyp

Der erste Befehl ruft das Bereitstellungstypobjekt DT2 für die Anwendung mit dem Namen Application1 ab und speichert das Objekt in der variablen $DeploymentType . Der zweite Befehl verwendet den Pipelineoperator, um den in $DeploymentType gespeicherten Bereitstellungstyp an Get-CMApplication zu übergeben, der die Anwendung für den Bereitstellungstyp abruft.

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

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die CI_ID einer abzurufenden Anwendung an. Beispiel: 136846.

Typ:Int32
Aliase:CIId, CI_ID
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Bereitstellungstypobjekt an, um die zugeordnete Anwendung abzurufen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMDeploymentType .

Typ:IResultObject
Aliase:DeploymentType
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ModelName

Geben Sie die ModelID einer abzurufenden Anwendung an. Beispiel: 136846.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen einer abzurufenden Anwendung an.

Typ:String
Aliase:LocalizedDisplayName, ApplicationName
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ShowHidden

Fügen Sie diesen Parameter hinzu, um ausgeblendete Anwendungen anzuzeigen. Für eine ausgeblendete Anwendung ist die IsHidden-Eigenschaft auf $truefestgelegt. Eine ausgeblendete App wird in der Configuration Manager-Konsole nicht angezeigt und wird nur mit diesem Cmdlet zurückgegeben, wenn Sie diesen Parameter angeben.

Verwenden Sie die folgenden Befehle, um eine Anwendung auszublenden:

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject[]

IResultObject

IResultObject

Hinweise

Weitere Informationen zu diesen Rückgabeobjekten und ihren Eigenschaften finden Sie in den folgenden Artikeln: