Set-CMApplicationGroup

Módulo:

ConfigurationManager

Configure um grupo de aplicativos existente.

Syntax

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para definir as configurações de um grupo de aplicativos existente. 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, consulte Criar grupos de aplicativos.

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: Renomear um grupo de aplicativos

Este exemplo obtém um objeto para o grupo de aplicativos e o passa para este cmdlet para renomeá-lo.

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

Exemplo 2: Adicionar um nome localizado

Este exemplo configura o grupo de aplicativos com um nome de aplicativo localizado para o idioma irlandês.

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

Parâmetros

-AddAppCatalog

Use este parâmetro para especificar uma entrada do Centro de Software para um idioma específico. Essa entrada pode incluir todas as informações localizadas sobre o grupo de aplicativos:

• Descrição
• IconLocationFile
• Palavra-chave
• LinkText
• PrivacyUrl
• Título
• UserDocumentation

Para obter esse objeto, use o cmdlet New-CMApplicationDisplayInfo.

Type:	AppDisplayInfo[]
Aliases:	AppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddAppCategory

Especifique um ou mais objetos de categoria administrativa para ajudá-lo a filtrar e encontrar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory. Essas categorias são do tipo AppCategories.

Para adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddUserCategory.

Type:	IResultObject[]
Aliases:	AddAppCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddApplication

Especifique uma matriz de cadeia de caracteres de nomes de aplicativos para adicionar ao grupo. Se você já tiver um objeto de aplicativo de outro cmdlet como Get-CMApplication,esse valor será a propriedade LocalizedDisplayName. Por exemplo: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

Type:	String[]
Aliases:	AddApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOwner

Especifique um ou mais usuários administrativos responsáveis por esse grupo de aplicativos.

Type:	String[]
Aliases:	AddOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddSupportContact

Especifique um ou mais usuários administrativos que os usuários finais possam contatar para obter ajuda com esse aplicativo.

Type:	String[]
Aliases:	AddSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddUserCategory

Especifique um ou mais objetos de categoria de usuário para ajudá-lo a filtrar e encontrar o grupo de aplicativos no console. Para obter esses objetos, use o cmdlet Get-CMCategory. Essas categorias são do tipo CatalogCategories.

Para adicionar categorias para ajudar os usuários a filtrar e localizar aplicativos no Centro de Software, use o parâmetro AddAppCategory.

Type:	IResultObject[]
Aliases:	AddUserCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplyToLanguageById

Para configurações exibidas no Centro de Software, use este parâmetro para especificar a ID do idioma para as configurações.

Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é para irlandês 0x083C (Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).

Por exemplo, para adicionar um nome de aplicativo localizado para o irlandês (Irlanda):

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type:	Int32
Aliases:	ApplySettingToSpecificLanguage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CleanAppCategory

Adicione esse parâmetro para remover todas as categorias administrativas. Para remover uma única categoria, use o parâmetro RemoveAppCategory.

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

-CleanUserCategory

Adicione esse parâmetro para remover todas as categorias de usuário. Para remover uma única categoria, use o parâmetro RemoveUserCategory.

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

-ClearAppCatalog

Adicione esse parâmetro para remover todas as entradas do Centro de Software localizado. Para remover uma única entrada, use o parâmetro RemoveAppCatalog.

Type:	SwitchParameter
Aliases:	ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOwner

Adicione esse parâmetro para remover todos os proprietários. Para remover um único proprietário, use o parâmetro RemoveOwner.

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

-ClearSupportContact

Adicione esse parâmetro para remover todos os contatos de suporte. Para remover um único contato, use o parâmetro RemoveSupportContact.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-DefaultLanguageId

Especifique a ID do idioma para o idioma padrão do Centro de Software.

Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é para irlandês 0x083C (Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).

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

-Description

Especifique um comentário de administrador opcional para o grupo de aplicativos. O comprimento máximo é de 2048 caracteres.

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

-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

-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

-IconLocationFile

Especifique o caminho para o arquivo que contém o ícone deste grupo de aplicativos. Os ícones podem ter dimensões de pixel de até 512x512. O arquivo pode ser dos seguintes tipos de arquivo de imagem e ícone:

• DLL
• EXE
• JPG
• ICO
• PNG

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

-Id

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

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

-InputObject

Especifique um objeto de grupo de aplicativos a ser configurada. Para obter esse objeto, use o cmdlet Get-CMApplicationGroup.

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Keyword

Especifique uma lista de palavras-chave no idioma selecionado. Essas palavras-chave ajudam os usuários do Centro de Software a pesquisar o grupo de aplicativos.

Dica

Para adicionar várias palavras-chave, use CultureInfo.CurrentCulture.TextInfo.ListSeparator como o delimiter.

Type:	String[]
Aliases:	Keywords
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LinkText

Ao usar o parâmetro UserDocumentation, use esse parâmetro para mostrar uma cadeia de caracteres no lugar de "Informações adicionais" no Centro de Software. O comprimento máximo é de 128 caracteres.

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

-LocalizedDescription

Especifique uma descrição para este grupo de aplicativos no idioma selecionado. O comprimento máximo é de 2048 caracteres.

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

-LocalizedName

Especifique o nome do grupo de aplicativos no idioma selecionado. Esse nome aparece no Centro de Software.

Um nome é necessário para cada idioma que você adicionar.

O comprimento máximo é de 256 caracteres.

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

-ModelName

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

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

-Name

Especifique o nome do grupo de aplicativos a ser configurada.

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

-NewName

Use esse parâmetro para renomear o grupo de aplicativos. O comprimento máximo é de 256 caracteres.

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

-OptionalReference

Especifique uma cadeia de caracteres opcional para ajudá-lo a encontrar o grupo de aplicativos no console. O comprimento máximo é de 256 caracteres.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-PrivacyUrl

Especifique um endereço de site para a declaração de privacidade do grupo de aplicativos. O formato precisa ser uma URL válida, por exemplo https://contoso.com/privacy . O comprimento máximo da cadeia de caracteres inteira é de 128 caracteres.

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

-Publisher

Especifique informações de fornecedor opcionais para este grupo de aplicativos. O comprimento máximo é de 256 caracteres.

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

-ReleaseDate

Especifique um objeto date para quando esse grupo de aplicativos foi lançado. Para obter esse objeto, use o cmdlet get-Date integrado.

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

-RemoveAppCatalog

Especifique uma matriz de IDs de idioma para remover as entradas do Centro de Software associado. Para remover todas as entradas, use o parâmetro ClearAppCatalog.

Essa ID é o equivalente decimal da ID Windows idioma. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos) e 2108 é para irlandês 0x083C (Irlanda). Para obter mais informações, consulte [MS-LCID]: referência Windows Identificador deCódigo de Idioma (LCID).

Por exemplo, para remover a entrada do Centro de Software localizado para a Irlanda (Irlanda):

-RemoveAppCatalog 2108

Type:	Int32[]
Aliases:	RemoveAppCatalogsByLanguageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveAppCategoryName

Especifique uma matriz de nomes de categoria administrativa a ser removido. Para remover todas as categorias administrativas, use o parâmetro CleanAppCategory.

Type:	String[]
Aliases:	RemoveAppCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveApplication

Especifique uma matriz de nomes de aplicativos a ser removido desse grupo.

Type:	String[]
Aliases:	RemoveApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOwner

Especifique uma matriz de proprietários a ser removido. Para remover todos os proprietários, use o parâmetro ClearOwner.

Type:	String[]
Aliases:	RemoveOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSupportContact

Especifique uma matriz de contatos de suporte a ser removido. Para remover todos os contatos de suporte, use o parâmetro ClearSupportContact.

Type:	String[]
Aliases:	RemoveSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUserCategoryName

Especifique uma matriz de nomes de categoria de usuário a ser removido. Para remover todas as categorias de usuário, use o parâmetro CleanUserCategory.

Type:	String[]
Aliases:	RemoveUserCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareVersion

Especifique uma cadeia de caracteres de versão opcional para o grupo de aplicativos. O tamanho máximo é de 64caracteres.

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

-UserDocumentation

Especifique o local de um arquivo do qual os usuários do Centro de Software podem obter mais informações sobre esse grupo de aplicativos. Esse local é um endereço de site ou um caminho de rede e nome de arquivo. Certifique-se de que os usuários tenham acesso a esse local.

O comprimento máximo da cadeia de caracteres inteira é de 256 caracteres.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Este cmdlet retorna o objeto SMS_ApplicationGroup classe WMI.

Links Relacionados

• Get-CMApplicationGroup
• New-CMApplicationGroup
• Remove-CMApplicationGroup
• New-CMApplicationDisplayInfo
• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Criar grupos de aplicativos