New-CMApplication
Criar um aplicativo.
Syntax
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
Use este cmdlet para criar um aplicativo. Um aplicativo do Configuration Manager define os metadados sobre o aplicativo. Para obter mais informações, consulte Create applications in Configuration Manager.
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 aplicativo
Este comando cria um aplicativo chamado 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 usuários administrativos responsáveis por esse aplicativo.
| 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 |
-AppCatalog
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 aplicativo:
- 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 |
-AutoInstall
De definir esse parâmetro como $true para permitir que o aplicativo seja instalado a partir da etapa de sequência de tarefas Instalar Aplicativo sem ser implantado.
| Type: | Boolean |
| 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: | False |
| 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 aplicativo. 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 |
-DisplaySupersedenceInApplicationCatalog
Não use esse parâmetro. O catálogo de aplicativos não tem mais suporte.
| Type: | Boolean |
| Aliases: | DisplaySupersedencesInApplicationCatalog |
| 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 aplicativo. 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 |
-IsFeatured
De definir esse parâmetro como $true para exibir esse aplicativo como um aplicativo em destaque e realça-lo no Portal da Empresa.
| Type: | Boolean |
| 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 aplicativo.
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 aplicativo no idioma selecionado. O comprimento máximo é de 2048 caracteres.
| Type: | String |
| Aliases: | LocalizedApplicationDescription |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalizedName
Especifique o nome do aplicativo 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: | LocalizedApplicationName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifique um nome para o aplicativo. O comprimento máximo é de 256 caracteres.
| Type: | String |
| Aliases: | LocalizedDisplayName |
| 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 aplicativo no console. O comprimento máximo é de 256 caracteres.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Especifique um usuário administrativo responsável por esse aplicativo.
| 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 aplicativo. 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 aplicativo. 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 este aplicativo 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 aplicativo. O tamanho máximo é de 64caracteres.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SupportContact
Especifique um usuário administrativo que os usuários finais possam contatar para ajudar com esse aplicativo.
| 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 aplicativo. 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: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Nenhum
Saídas
IResultObject
IResultObject
Observações
Para obter mais informações sobre esse objeto de retorno e suas propriedades, consulte SMS_Application classe WMI do servidor.