New-CMApplicationGroup
Crie um novo grupo de aplicações.
Sintaxe
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 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.
Existem algumas definições de um grupo de aplicações que não pode configurar ao criá-lo. Para configurar outras definições, utilize o cmdlet Set-CMApplicationGroup .
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: Criar um grupo com duas aplicações
Este exemplo cria um novo grupo de aplicações com o nome Aplicação central 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'Parâmetros
-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: | True |
| 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 |
-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:
- 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 |
-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 |
-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 |
-Name
Especifique um nome para o grupo de aplicações. O comprimento máximo é de 256 caracteres.
| Tipo: | String |
| Aliases: | LocalizedDisplayName, ApplicationGroupName |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| 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 |
-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 |
-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
None
Saídas
IResultObject
Observações
Este cmdlet devolve o SMS_ApplicationGroup objeto de classe WMI.