Partilhar via


New-CMApplicationGroup

SYNOPSIS

Criar um novo grupo de aplicações.

SYNTAX

New-CMApplicationGroup [-Name] <String> -AddApplication <String[]> [-Description <String>]
 [-Publisher <String>] [-SoftwareVersion <String>] [-OptionalReference <String>] [-ReleaseDate <DateTime>]
 [-AddOwner <String[]>] [-AddSupportContact <String[]>] [-AppGroupCatalog <AppDisplayInfo[]>]
 [-DefaultLanguageId <Int32>] [-LocalizedName <String>] [-UserDocumentation <String>] [-LinkText <String>]
 [-PrivacyUrl <String>] [-LocalizedDescription <String>] [-Keyword <String[]>] [-IconLocationFile <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Utilize este cmdlet para criar um grupo de aplicações. Utilize um grupo de aplicações para implementar várias aplicações numa recolha como uma única implantaçã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.

Existem algumas configurações de um grupo de aplicações que não pode configurar quando a cria. Para configurar outras definições, utilize o cmdlet Set-CMApplicationGroup.

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: Criar um grupo com duas apps

Este exemplo cria um novo grupo de aplicações chamado Central app que inclui duas aplicações.

$apps = @('LOB Framework','CA UI')

New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'

PARAMETERS

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

-AppGroupCatalog

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

-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

-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

-Name

Especifique um nome para o grupo de aplicações. O comprimento máximo é de 256 caracteres.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName, ApplicationGroupName

Required: True
Position: 0
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

-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

-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

Nenhuma

OUTPUTS

IResultObject#SMS_ApplicationGroup

NOTAS

Este cmdlet devolve o SMS_ApplicationGroup objeto da classe WMI.

Grupo Get-CMApplication Grupo de Remoção-CMApplication Grupo set-CMApplication

New-CMApplicationDisplayInfo

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

Criar grupos de aplicações