New-CMApplication
Criar uma aplicação.
Sintaxe
New-CMApplication
[-AddOwner <String[]>]
[-AddSupportContact <String[]>]
[-AppCatalog <AppDisplayInfo[]>]
[-AutoInstall <Boolean>]
[-DefaultLanguageId <Int32>]
[-Description <String>]
[-DisplaySupersedenceInApplicationCatalog <Boolean>]
[-IconLocationFile <String>]
[-IsFeatured <Boolean>]
[-Keyword <String[]>]
[-LinkText <String>]
[-LocalizedDescription <String>]
[-LocalizedName <String>]
[-Name] <String>
[-OptionalReference <String>]
[-Owner <String>]
[-PrivacyUrl <String>]
[-Publisher <String>]
[-ReleaseDate <DateTime>]
[-SoftwareVersion <String>]
[-SupportContact <String>]
[-UserDocumentation <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Utilize este cmdlet para criar uma aplicação. Uma aplicação do Configuration Manager define os metadados sobre a aplicação. Para obter mais informações, veja Criar aplicações no Configuration Manager.
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 uma aplicação
Este comando cria uma aplicação com o nome Application01.
New-CMApplication -Name "Application01" -Description "New Application" -Publisher "Contoso" -SoftwareVersion "1.0.0.1" -OptionalReference "Reference" -ReleaseDate 2/24/2016 -AutoInstall $True -Owner "Administrator" -SupportContact "Administrator" -LocalizedName "Application01" -UserDocumentation "https://contoso.com/content" -LinkText "For more information" -LocalizedDescription "New Localized Application" -Keyword "application" -PrivacyUrl "https://contoso.com/library/privacy" -IsFeatured $True -IconLocationFile "\\central\icons\icon.png"Parâmetros
-AddOwner
Especifique um ou mais utilizadores administrativos responsáveis por esta aplicação.
| 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 |
-AppCatalog
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 a aplicação:
- 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 |
-AutoInstall
Defina este parâmetro como $true para permitir que a aplicação seja instalada a partir do passo de sequência de tarefas Instalar Aplicação sem ser implementada.
| Tipo: | Boolean |
| 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: | False |
| 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 a aplicação. 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 |
-DisplaySupersedenceInApplicationCatalog
Não utilize este parâmetro. O catálogo de aplicações já não é suportado.
| Tipo: | Boolean |
| Aliases: | DisplaySupersedencesInApplicationCatalog |
| 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 desta aplicação. 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 |
-IsFeatured
Defina este parâmetro como $true para apresentar esta aplicação como uma aplicação em destaque e realçá-la no Portal da Empresa.
| Tipo: | Boolean |
| 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 a aplicação.
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 esta aplicação no idioma selecionado. O comprimento máximo é de 2048 caracteres.
| Tipo: | String |
| Aliases: | LocalizedApplicationDescription |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LocalizedName
Especifique o nome da aplicação 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: | LocalizedApplicationName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique um nome para a aplicação. O comprimento máximo é de 256 caracteres.
| Tipo: | String |
| Aliases: | LocalizedDisplayName |
| 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 a aplicação 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 |
-Owner
Especifique um utilizador administrativo responsável por esta aplicação.
| 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 da aplicação. 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 esta aplicação. 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 esta aplicação foi lançada. 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 a aplicação. 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 |
-SupportContact
Especifique um utilizador administrativo que os utilizadores finais possam contactar para obter ajuda com esta aplicação.
| 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 esta aplicação. 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: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Application classe WMI de servidor.