Get-CMProgram

Obtenha um programa de um pacote.

Syntax

Get-CMProgram
   [-PackageName <String>]
   [-ProgramName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMProgram
   -Package <IResultObject>
   [-ProgramName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMProgram
   -PackageId <String>
   [-ProgramName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter um programa de um pacote. Os programas identificam as ações que ocorrem quando o cliente recebe o pacote cliente. Você pode associar vários programas ao mesmo pacote. Para obter mais informações, consulte Pacotes e programas em Configuration Manager.

Observação

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

Exemplos

Exemplo 1: obter um programa usando um nome e uma ID

Esse comando obtém o programa chamado Script no pacote que tem a ID XYZ0000F.

Get-CMProgram -PackageId "XYZ0000F" -ProgramName "Script"

Parâmetros

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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). Você não pode combiná-lo com DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Package

Especifique um objeto de pacote com o programa a ser obtido. Para obter esse objeto, use o cmdlet Get-CMPackage .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

Especifique a ID do pacote com o programa a ser obtido.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PackageName

Especifique o nome do pacote com o programa a ser obtido.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgramName

Especifique o nome do programa no pacote.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject[]

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Program classe WMI do servidor.