New-CMApplicationDisplayInfo

  • Referência
Módulo:
ConfigurationManager

Crie uma entrada do Centro de Software para uma aplicação ou grupo de aplicações.

Sintaxe

New-CMApplicationDisplayInfo
   [-Description <String>]
   [-IconLocationFile <String>]
   [-Keyword <String[]>]
   -LanguageId <Int32>
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   -Title <String>
   [-UserDocumentation <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para criar uma entrada do Centro de Software para uma aplicação ou grupo de aplicações. Especifique informações sobre como pretende apresentar esta aplicação ou grupo de aplicações aos utilizadores quando procurarem no Centro de Software. Para fornecer informações num idioma específico, especifique o ID de idioma.

Este cmdlet cria um objeto que pode transmitir para os cmdlets New-CMApplication, New-CMApplicationGroup, Set-CMApplication e 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

Este exemplo recolhe todas as definições de uma entrada de grupo de aplicações no idioma irlandês e, em seguida, adiciona-as ao grupo de aplicações.

$welcomeAppInfoIrish = New-CMApplicationDisplayInfo -Description "Fáilte a Contoso! Go raibh maith agat faoi theacht chugainn." -IconLocationFile "\\central\icons\welcome.ico" -Keyword "fostaí","nua" -LanguageId 60 -LinkText "Mar eolas duit" -PrivacyUrl "https://contoso.com/privacy" -Title "Fáilte romhat" -UserDocumentation "https://my.contoso.com/welcome"

Set-CMApplicationGroup -Name "Contoso Welcome app" -AddAppCatalog $welcomeAppInfoIrish

Parâmetros

-Description

Especifique uma descrição para esta aplicação no idioma especificado. O comprimento máximo é de 2048 caracteres.

Tipo:String
Aliases:LocalizedDescription
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 da 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

-Keyword

Especifique uma lista de palavras-chave no idioma especificado. Estas palavras-chave ajudam os utilizadores do Centro de Software a procurar a aplicação.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LanguageId

Utilize este parâmetro para especificar o ID de idioma para as definições.

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

-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

-Title

Especifique o nome da aplicação no idioma especificado. Este nome é apresentado no Centro de Software. O comprimento máximo é de 256 caracteres.

Tipo:String
Aliases:LocalizedName
Cargo:Named
Valor padrão:None
Obrigatório:True
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

Entradas

None

Saídas

AppDisplayInfo