Share via


Get-CMApplicationGroup

Obtenha um grupo de aplicativos.

Syntax

Get-CMApplicationGroup
   [[-Name] <String>]
   [-ShowHidden]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApplicationGroup
   -Id <Int32>
   [-ShowHidden]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMApplicationGroup
   -ModelName <String>
   [-ShowHidden]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obter um grupo de aplicativos. Use um grupo de aplicativos para implantar vários aplicativos em uma coleção como uma única implantação. Os metadados especificados sobre o grupo de aplicativos são vistos no Centro de Software como uma única entidade. Você pode solicitar os aplicativos no grupo para que o cliente os instale em uma ordem específica. Para obter mais informações, confira Criar grupos de aplicativos.

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

Este exemplo obtém um grupo de aplicativos chamado aplicativo Central.

Get-CMApplicationGroup -Name 'Central app'

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

-Id

Especifique a ID do grupo de aplicativos a ser obtido. Esse valor é o mesmo que o CI_ID, por exemplo 1025866.

Type:Int32
Aliases:CIId, CI_ID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ModelName

Especifique o identificador de modelo de aplicativo do grupo de aplicativos a ser obtido. Esse valor também é conhecido como ID Exclusiva de CI. Por exemplo, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

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

-Name

Especifique o nome do grupo de aplicativos a ser obtido.

Type:String
Aliases:LocalizedDisplayName, ApplicationGroupName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowHidden

Adicione esse parâmetro para mostrar grupos de aplicativos ocultos. Um grupo de aplicativos ocultos tem a propriedade IsHidden definida como $true. Um grupo de aplicativos oculto não é exibido no console Configuration Manager e ele só retorna com esse cmdlet quando você especifica esse parâmetro.

Para ocultar um grupo de aplicativos, use os seguintes comandos:

$appGroup = Get-CMApplicationGroup -Nome "grupo de aplicativos de teste" $appGroup.IsHidden = $true $appGroup.Put()

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

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Este cmdlet retorna o objeto de classe WMI SMS_ApplicationGroup .