Partilhar via


New-CMApplication

SYNOPSIS

Criar uma aplicação.

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

Utilize este cmdlet para criar uma aplicação. Uma aplicação do Gestor de Configuração define os metadados sobre a aplicação. Para obter mais informações, consulte Criar aplicações no Gestor de Configurações.

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 uma aplicação

Este comando cria uma aplicação chamada 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"

PARAMETERS

-AddOwner

Especifique um ou mais utilizadores administrativos responsáveis por esta aplicação.

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

-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:

  • 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

-Autoinstall

Desloque este parâmetro para $true para permitir que a aplicação seja instalada a partir do passo da sequência de tarefas de instalação da aplicação sem ser implantada.

Type: Boolean
Parameter Sets: (All)
Aliases:

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: False
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 a aplicação. 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

-DisplaySupersedenceInApplicationCatalog

Não use este parâmetro. O catálogo de aplicações já não é suportado.

Type: Boolean
Parameter Sets: (All)
Aliases: DisplaySupersedencesInApplicationCatalog

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 esta aplicação. 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

-IsFeatured

Desaprote este parâmetro para $true para apresentar esta aplicação como uma aplicação em destaque e realçá-la no Portal da Empresa.

Type: Boolean
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 a aplicação.

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 esta aplicação no idioma selecionado. O comprimento máximo é de 2048 caracteres.

Type: String
Parameter Sets: (All)
Aliases: LocalizedApplicationDescription

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Nome localizado

Especifique o nome da aplicação 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: LocalizedApplicationName

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Especifique um nome para a aplicação. O comprimento máximo é de 256 caracteres.

Type: String
Parameter Sets: (All)
Aliases: LocalizedDisplayName

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 a aplicação 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

-Proprietário

Especifique um utilizador administrativo responsável por esta aplicação.

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 a aplicação. 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 as informações opcionais do fornecedor para esta aplicação. 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 esta aplicação foi lançada. 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 a aplicação. 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

-SupportContact

Especifique um utilizador administrativo que os utilizadores finais podem contactar para ajudar com esta aplicação.

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 esta aplicação. 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: False
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_ApplicationLatest

IResultObject#SMS_Application

NOTAS

Para obter mais informações sobre este objeto de retorno e suas propriedades, consulte SMS_Application classe WMI do servidor.

Conversão-CMApplicação

ConversãoFrom-CMApplication

ConverteTo-CMApplicação

Exportação-CMApplicação

Get-CMApplication

Aplicação cm-importação

Remoção-CMApplicação

Resumo-CMApplicação

Set-CMApplicação

Suspensão-CMApplicação

New-CMApplicationDisplayInfo

Criar aplicações no Gestor de Configuração