Partilhar via


Set-CMApplicationGroup

SYNOPSIS

Configure um grupo de candidatura existente.

SYNTAX

SetByValue (Padrão)

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>]

SetById

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>]

SetByModelName

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>]

SetByName

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 para uma coleção como uma única implementação. Os metadados que especifica sobre o grupo de aplicações são vistos no Software Center como uma única entidade. Pode encomendar as aplicações do grupo para que o cliente as instale numa ordem específica. Para obter mais informações, consulte Criar grupos de aplicações.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Mude o nome de um grupo de aplicações

Este exemplo obtém um objeto para o grupo de aplicações, e passa-o a 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 aplicações com um nome de aplicação localizado para a língua irlandesa.

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

PARAMETERS

-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:

  • Description
  • IconLocationFile
  • Palavra-chave
  • LinkText
  • PrivacyUrl
  • Título
  • Utilização do Utilizador

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

Type: AppDisplayInfo[]
Parameter Sets: (All)
Aliases: AppCatalogs

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

-AddAppCategoria

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

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAppCategories

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

-AddApplication

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

Type: String[]
Parameter Sets: (All)
Aliases: AddApplications

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

-AddOwner

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

Type: String[]
Parameter Sets: (All)
Aliases: AddOwners

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

-AddSupportContact

Especifique um ou mais utilizadores administrativos que os utilizadores finais podem contactar para ajudar com esta aplicação.

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts

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

-AddUserCategoria

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

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddUserCategories

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

-ApplyToLanguageById

Para as definições que são apresentadas no Software Center, utilize este parâmetro para especificar o ID do idioma para as definições.

Esta identificação é o equivalente decimal do ID linguístico Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos), e 2108 é para 0x083C irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Windows referência do identificador de código linguístico (LCID).

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

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type: Int32
Parameter Sets: (All)
Aliases: ApplySettingToSpecificLanguage

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

-CleanAppCategoria

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanAppCategories

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

-CleanUserCategoria

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanUserCategories

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

-ClearAppCatalog

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs

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

-ClearOwner

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanOwners

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

-ClearSupportContact

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: CleanSupportContacts

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

-Confirm

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DefaultLanguageId

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

Esta identificação é o equivalente decimal do ID linguístico Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos), e 2108 é para 0x083C irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Windows referência do identificador de código linguístico (LCID).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IconLocationFile

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

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Type: String
Parameter Sets: (All)
Aliases:

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

- ID

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

Type: Int32
Parameter Sets: SetById
Aliases: CIId, CI_ID

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Especifique um objeto de grupo de aplicativos para configurar. Para obter este objeto, utilize o cmdlet Get-CMApplicationGroup.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: ApplicationGroup

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Palavra-chave

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

Dica

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

Type: String[]
Parameter Sets: (All)
Aliases: Keywords

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

-LinkText

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Descrição localizada

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

Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupDescription

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

-Nome localizado

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

É necessário um nome para cada idioma que se adiciona.

O comprimento máximo é de 256 caracteres.

Type: String
Parameter Sets: (All)
Aliases: LocalizedAppGroupName

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

-Nome modelo

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

Type: String
Parameter Sets: SetByModelName
Aliases:

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

-Name

Especifique o nome do grupo de aplicações para configurar.

Type: String
Parameter Sets: SetByName
Aliases: LocalizedDisplayName, ApplicationGroupName

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Novo Nome

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Referência opcional

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

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PrivacyUrl

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

Type: String
Parameter Sets: (All)
Aliases:

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

- Publisher

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

Type: String
Parameter Sets: (All)
Aliases: Manufacturer

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

-ReleaseDate

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

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Remover OAppCatalog

Especifique um conjunto de IDs de idioma para remover as entradas associadas do Software Center. Para remover todas as entradas, utilize o parâmetro ClearAppCatalog.

Esta identificação é o equivalente decimal do ID linguístico Windows. Por exemplo, 1033 é 0x0409 para inglês (Estados Unidos), e 2108 é para 0x083C irlandês (Irlanda). Para obter mais informações, consulte [MS-LCID]: Windows referência do identificador de código linguístico (LCID).

Por exemplo, para remover a entrada localizada do Software Center para o Irlandês (Irlanda):

-RemoveAppCatalog 2108

Type: Int32[]
Parameter Sets: (All)
Aliases: RemoveAppCatalogsByLanguageId

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

-Remover O Nome daCategoria

Especifique um conjunto de nomes de categoria administrativa para remover. Para remover todas as categorias administrativas, utilize o parâmetro CleanAppCategory.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveAppCategoryNames

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

-Remover a Aplicação

Especifique um conjunto de nomes de aplicações para remover deste grupo.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveApplications

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

-RemoveOwner

Especifique uma série de proprietários para remover. Para remover todos os proprietários, utilize o parâmetro ClearOwner.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveOwners

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

-RemoverSupportContact

Especifique uma série de contactos de suporte para remover. Para remover todos os contactos de suporte, utilize o parâmetro ClearSupportContact.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveSupportContacts

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

-RemoveUserCategoriaName

Especifique um conjunto de nomes da categoria de utilizador para remover. Para remover todas as categorias de utilizador, utilize o parâmetro CleanUserCategory.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveUserCategoryNames

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

-Versão de Software

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Utilização do Utilizador

Especifique a localização de um ficheiro a partir do qual os utilizadores do Software Center 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 arquivo. Certifique-se de que os utilizadores têm acesso a este local.

O comprimento máximo de toda a corda é de 256 caracteres.

Type: String
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_ApplicationGroup

Este cmdlet devolve o SMS_ApplicationGroup objeto da classe WMI.

NOTAS

Grupo Get-CMApplication Grupo de Aplicação De Novos CM Grupo de Remoção-CMApplication

New-CMApplicationDisplayInfo

Get-CMApplicationGroupDeployment Novo CmApplicationGroupDeployment Remoção-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment

Criar grupos de aplicações