Get-CMApplication
Obter um aplicativo.
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 este cmdlet para obter um aplicativo do Configuration Manager. Um aplicativo do Configuration Manager define os metadados sobre o aplicativo. Um aplicativo tem um ou mais tipos de implantação. Esses tipos de implantação incluem os arquivos de instalação e as informações necessárias para instalar o software em dispositivos. Um tipo de implantação também tem regras, como métodos de detecção e requisitos. Essas regras especificam quando e como o cliente instala o software.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Obter um aplicativo pelo nome
Este comando obtém o objeto application chamado Application1.
Get-CMApplication -Name "Application1"
Exemplo 2: Obter o aplicativo para um tipo de implantação
O primeiro comando obtém o objeto de tipo de implantação chamado DT2 para o aplicativo chamado Application1 e armazena o objeto na variável $DeploymentType de implantação. O segundo comando usa o operador de **** pipeline para passar o tipo de implantação armazenado no $DeploymentType para Get-CMApplication, que obtém o aplicativo para o tipo de implantação.
$DeploymentType = Get-CMDeploymentType -DeploymentTypeName "DT2" -ApplicationName "Application1"
$DeploymentType | Get-CMApplication
Parâmetros
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Fast
Adicione esse parâmetro para não atualizar automaticamente as propriedades desleisadas. Propriedades flexíveis contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.
Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, de definir $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique o CI_ID de um aplicativo a ser obter. Por exemplo, 136846
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto de tipo de implantação para obter o aplicativo associado. Para obter esse objeto, use o cmdlet Get-CMDeploymentType.
Type: | IResultObject |
Aliases: | DeploymentType |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ModelName
Especifique o ModelID de um aplicativo a ser obter. Por exemplo, 136846
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique o nome de um aplicativo a ser obter.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-ShowHidden
Adicione esse parâmetro para mostrar aplicativos ocultos. Um aplicativo oculto tem a propriedade IsHidden definida como $true
. Um aplicativo oculto não é exibido no console do Configuration Manager e só retorna com esse cmdlet quando você especifica esse parâmetro.
Para ocultar um aplicativo, use os seguintes comandos:
$app = Get-CMApplication -Name "test app" $app. IsHidden = $true $app. Put()
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject[]
IResultObject
IResultObject
Observações
Para obter mais informações sobre esses objetos de retorno e suas propriedades, consulte os seguintes artigos: