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.
RELATED LINKS
Grupo Get-CMApplication Grupo de Remoção-CMApplication Grupo set-CMApplication
Get-CMApplicationGroupDeployment Novo CmApplicationGroupDeployment Remoção-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment