Compartilhar via

Set-CMApplicationGroup

  • Referência
Módulo:
ConfigurationManager

Configurar um grupo de aplicações existente.

Sintaxe

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

Utilize este cmdlet para configurar as definições de um grupo de aplicações existente. Utilize um grupo de aplicações para implementar várias aplicações numa coleção como uma única implementação. Os metadados que especificar sobre o grupo de aplicações são vistos no Centro de Software como uma única entidade. Pode encomendar as aplicações no grupo para que o cliente as instale por uma ordem específica. Para obter mais informações, veja Criar grupos de aplicações.

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: Mudar o nome de um grupo de aplicações

Este exemplo obtém um objeto para o grupo de aplicações e transmite-o a este cmdlet para mudar o nome do mesmo.

$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 aplicações com um nome de aplicação localizado para o idioma irlandês .

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

Parâmetros

-AddAppCatalog

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

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

Para obter este objeto, utilize o cmdlet New-CMApplicationDisplayInfo .

Tipo:AppDisplayInfo[]
Aliases:AppCatalogs
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddAppCategory

Especifique um ou mais objetos de categoria administrativa para o ajudar a filtrar e localizar o grupo de aplicações na consola do . Para obter estes objetos, utilize o cmdlet Get-CMCategory . Estas categorias são do tipo AppCategories.

Para adicionar categorias para ajudar os utilizadores a filtrar e localizar aplicações no Centro de Software, utilize o parâmetro AddUserCategory .

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

-AddApplication

Especifique uma matriz de cadeia de nomes de aplicações a adicionar ao grupo. Se já tiver um objeto de aplicação de outro cmdlet como Get-CMApplication, este valor é a propriedade LocalizedDisplayName . Por exemplo: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

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

-AddOwner

Especifique um ou mais utilizadores administrativos responsáveis por este grupo de aplicações.

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

-AddSupportContact

Especifique um ou mais utilizadores administrativos que os utilizadores finais possam contactar para obter ajuda com esta aplicação.

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

-AddUserCategory

Especifique um ou mais objetos de categoria de utilizador para o ajudar a filtrar e localizar o grupo de aplicações na consola do . Para obter estes objetos, utilize o cmdlet Get-CMCategory . Estas categorias são do tipo CatalogCategories.

Para adicionar categorias para ajudar os utilizadores a filtrar e localizar aplicações no Centro de Software, utilize o parâmetro AddAppCategory .

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

-ApplyToLanguageById

Para as definições apresentadas no Centro de Software, utilize este parâmetro para especificar o ID de idioma das definições.

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

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

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

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

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

-CleanUserCategory

Adicione este parâmetro para remover todas as categorias de utilizador. Para remover uma única categoria, utilize o parâmetro RemoveUserCategory .

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

-ClearAppCatalog

Adicione este parâmetro para remover todas as entradas localizadas do Centro de Software. Para remover uma única entrada, utilize o parâmetro RemoveAppCatalog .

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

-ClearOwner

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

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

-ClearSupportContact

Adicione este parâmetro para remover todos os contactos de suporte. Para remover um único contacto, utilize o parâmetro RemoveSupportContact .

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

-Confirm

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

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

-DefaultLanguageId

Especifique o ID de idioma para o idioma predefinido do Centro de Software.

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

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

-Description

Especifique um comentário de administrador opcional para o grupo de aplicações. O comprimento máximo é de 2048 caracteres.

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

-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

-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

-IconLocationFile

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

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID do grupo de aplicações a configurar. Este valor é o mesmo que o CI_ID, por exemplo 1025866.

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

-InputObject

Especifique um objeto de grupo de aplicações a configurar. Para obter este objeto, utilize o cmdlet Get-CMApplicationGroup .

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

-Keyword

Especifique uma lista de palavras-chave no idioma selecionado. Estas palavras-chave ajudam os utilizadores do Centro de Software a procurar o grupo de aplicações.

Dica

Para adicionar várias palavras-chave, utilize CultureInfo.CurrentCulture.TextInfo.ListSeparator como delimitador.

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

-LinkText

Quando utilizar o parâmetro UserDocumentation , utilize este parâmetro para mostrar uma cadeia em vez de "Informações adicionais" no Centro de Software. O comprimento máximo é de 128 caracteres.

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

-LocalizedDescription

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

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

-LocalizedName

Especifique o nome do grupo de aplicações no idioma selecionado. Este nome é apresentado no Centro de Software.

É necessário um nome para cada idioma que adicionar.

O comprimento máximo é de 256 caracteres.

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

-ModelName

Especifique o identificador do modelo de aplicação do grupo de aplicações a configurar. Este valor também é conhecido como ID Exclusivo de CI. Por exemplo, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

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 do grupo de aplicações a configurar.

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

-NewName

Utilize este parâmetro para mudar o nome do grupo de aplicações. O comprimento máximo é de 256 caracteres.

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

-OptionalReference

Especifique uma cadeia opcional para o ajudar a encontrar o grupo de aplicações na consola do . O comprimento máximo é de 256 caracteres.

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-PrivacyUrl

Especifique um endereço do site para a declaração de privacidade do grupo de aplicações. O formato tem de ser um URL válido, por exemplo https://contoso.com/privacy. O comprimento máximo de toda a cadeia é de 128 carateres.

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

-Publisher

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

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

-ReleaseDate

Especifique um objeto de data para quando este grupo de aplicações foi lançado. Para obter este objeto, utilize o cmdlet incorporado Get-Date .

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

-RemoveAppCatalog

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

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

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

-RemoveAppCatalog 2108

Tipo:Int32[]
Aliases:RemoveAppCatalogsByLanguageId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveAppCategoryName

Especifique uma matriz de nomes de categorias administrativas a remover. Para remover todas as categorias administrativas, utilize o parâmetro CleanAppCategory .

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

-RemoveApplication

Especifique uma matriz de nomes de aplicações a remover deste grupo.

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

-RemoveOwner

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

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

-RemoveSupportContact

Especifique uma matriz de contactos de suporte a remover. Para remover todos os contactos de suporte, utilize o parâmetro ClearSupportContact .

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

-RemoveUserCategoryName

Especifique uma matriz de nomes de categoria de utilizador a remover. Para remover todas as categorias de utilizador, utilize o parâmetro CleanUserCategory .

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

-SoftwareVersion

Especifique uma cadeia de versão opcional para o grupo de aplicações. O tamanho máximo é de 64 caracteres.

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

-UserDocumentation

Especifique a localização de um ficheiro a partir do qual os utilizadores do Centro de Software podem obter mais informações sobre este grupo de aplicações. Esta localização é um endereço do site ou um caminho de rede e nome de ficheiro. Certifique-se de que os utilizadores têm acesso a esta localização.

O comprimento máximo de toda a cadeia é de 256 carateres.

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

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
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

Este cmdlet devolve o objeto de classe WMI SMS_ApplicationGroup.