New-CMApplicationGroup
Crie um novo grupo de aplicativos.
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
Use este cmdlet para criar um grupo de aplicativos. 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.
Há algumas configurações de um grupo de aplicativos que você não pode configurar ao criar. Para definir outras configurações, use o cmdlet Set-CMApplicationGroup.
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: Criar um grupo com dois aplicativos
Este exemplo cria um novo grupo de aplicativos chamado Aplicativo Central que inclui dois aplicativos.
$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'Parâmetros
-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 |
-AppGroupCatalog
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 |
-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 |
-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 |
-Name
Especifique um nome para o grupo de aplicativos. O comprimento máximo é de 256 caracteres.
| Type: | String |
| Aliases: | LocalizedDisplayName, ApplicationGroupName |
| Position: | 0 |
| 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 |
-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 |
-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
Nenhum
Saídas
IResultObject
Observações
Este cmdlet retorna o objeto SMS_ApplicationGroup classe WMI.