Compartilhar via

Get-CMApplication

  • Referência
Módulo:
ConfigurationManager

Obter uma aplicação.

Sintaxe

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

Utilize este cmdlet para obter uma aplicação do Configuration Manager. Uma aplicação do Configuration Manager define os metadados sobre a aplicação. Uma aplicação tem um ou mais tipos de implementação. Estes tipos de implementação incluem os ficheiros de instalação e as informações necessárias para instalar software em dispositivos. Um tipo de implementação também tem regras, como métodos e requisitos de deteção. Estas regras especificam quando e como o cliente instala o software.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Obter uma aplicação pelo nome

Este comando obtém o objeto da aplicação com o nome Application1.

Get-CMApplication -Name "Application1"

Exemplo 2: Obter a aplicação para um tipo de implementação

O primeiro comando obtém o objeto de tipo de implementação denominado DT2 para a aplicação com o nome Application1 e armazena o objeto na variável $DeploymentType . O segundo comando utiliza o operador de pipeline para transmitir o tipo de implementação armazenado no $DeploymentType para Get-CMApplication, que obtém a aplicação para o tipo de implementação.

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

Parâmetros

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Fast

Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o CI_ID de uma aplicação a obter. Por exemplo, 136846.

Tipo:Int32
Aliases:CIId, CI_ID
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de tipo de implementação para obter a aplicação associada. Para obter este objeto, utilize o cmdlet Get-CMDeploymentType .

Tipo:IResultObject
Aliases:DeploymentType
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ModelName

Especifique o ModelID de uma aplicação a obter. Por exemplo, 136846.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique o nome de uma aplicação a obter.

Tipo:String
Aliases:LocalizedDisplayName, ApplicationName
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-ShowHidden

Adicione este parâmetro para mostrar aplicações ocultas. Uma aplicação oculta tem a propriedade IsHidden definida como $true. Uma aplicação oculta não é apresentada na consola do Configuration Manager e só é devolvida com este cmdlet quando especificar este parâmetro.

Para ocultar uma aplicação, utilize os seguintes comandos:

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

IResultObject

Observações

Para obter mais informações sobre estes objetos devolvidos e as respetivas propriedades, veja os seguintes artigos: