New-CMApplication

  • Referencia
Módulo:
ConfigurationManager

Cree una aplicación.

Sintaxis

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 crear una aplicación. Una aplicación de Configuration Manager define los metadatos sobre la aplicación. Para obtener más información, consulte Creación de aplicaciones en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Creación de una aplicación

Este comando crea una aplicación denominada 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 uno o varios usuarios administrativos responsables de esta aplicación.

Tipo:String[]
Alias:AddOwners
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AddSupportContact

Especifique uno o varios usuarios administrativos con los que los usuarios finales puedan ponerse en contacto para obtener ayuda con esta aplicación.

Tipo:String[]
Alias:AddSupportContacts
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AppCatalog

Use este parámetro para especificar una entrada del Centro de software para un idioma específico. Esta entrada puede incluir toda la información localizada sobre la aplicación:

  • Descripción
  • IconLocationFile
  • Palabra clave
  • LinkText
  • PrivacyUrl
  • Cargo
  • UserDocumentation

Para obtener este objeto, use el cmdlet New-CMApplicationDisplayInfo .

Tipo:AppDisplayInfo[]
Alias:AppCatalogs
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AutoInstall

Establezca este parámetro en $true para permitir que la aplicación se instale desde el paso de secuencia de tareas Instalar aplicación sin implementarse.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultLanguageId

Especifique el identificador de idioma para el idioma predeterminado del Centro de software.

Este identificador es el equivalente decimal del identificador de idioma de Windows. Por ejemplo, 1033 es 0x0409 para inglés (Estados Unidos) y 2108 es 0x083C para irlandés (Irlanda). Para obtener más información, vea [MS-LCID]: Referencia del identificador de código de lenguaje (LCID) de Windows.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifique un comentario de administrador opcional para la aplicación. La longitud máxima es de 2048 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisplaySupersedenceInApplicationCatalog

No use este parámetro. Ya no se admite el catálogo de aplicaciones.

Tipo:Boolean
Alias:DisplaySupersedencesInApplicationCatalog
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IconLocationFile

Especifique la ruta de acceso al archivo que contiene el icono de esta aplicación. Los iconos pueden tener dimensiones de píxeles de hasta 512 x 512. El archivo puede ser de los siguientes tipos de archivo de imagen e icono:

  • DLL
  • EXE
  • JPG
  • ICO
  • PNG
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsFeatured

Establezca este parámetro en $true para mostrar esta aplicación como una aplicación destacada y resaltarla en el Portal de empresa.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Keyword

Especifique una lista de palabras clave en el idioma seleccionado. Estas palabras clave ayudan a los usuarios del Centro de software a buscar la aplicación.

Sugerencia

Para agregar varias palabras clave, use CultureInfo.CurrentCulture.TextInfo.ListSeparator como delimitador.

Tipo:String[]
Alias:Keywords
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LinkText

Cuando use el parámetro UserDocumentation , use este parámetro para mostrar una cadena en lugar de "Información adicional" en el Centro de software. Se permite una longitud máxima de 128 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalizedDescription

Especifique una descripción para esta aplicación en el idioma seleccionado. La longitud máxima es de 2048 caracteres.

Tipo:String
Alias:LocalizedApplicationDescription
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalizedName

Especifique el nombre de la aplicación en el idioma seleccionado. Este nombre aparece en el Centro de software.

Se requiere un nombre para cada idioma que agregue.

La longitud máxima es de 256 caracteres.

Tipo:String
Alias:LocalizedApplicationName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique un nombre para la aplicación. La longitud máxima es de 256 caracteres.

Tipo:String
Alias:LocalizedDisplayName
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OptionalReference

Especifique una cadena opcional para ayudarle a encontrar la aplicación en la consola. La longitud máxima es de 256 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Owner

Especifique un usuario administrativo responsable de esta aplicación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrivacyUrl

Especifique una dirección de sitio web para la declaración de privacidad de la aplicación. El formato debe ser una dirección URL válida, por ejemplo https://contoso.com/privacy. La longitud máxima de toda la cadena es de 128 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Publisher

Especifique la información opcional del proveedor para esta aplicación. La longitud máxima es de 256 caracteres.

Tipo:String
Alias:Manufacturer
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ReleaseDate

Especifique un objeto de fecha para cuándo se publicó esta aplicación. Para obtener este objeto, use el cmdlet integrado Get-Date .

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SoftwareVersion

Especifique una cadena de versión opcional para la aplicación. La longitud máxima es de 64 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SupportContact

Especifique un usuario administrativo con el que los usuarios finales puedan ponerse en contacto para obtener ayuda con esta aplicación.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserDocumentation

Especifique la ubicación de un archivo desde el que los usuarios del Centro de software pueden obtener más información sobre esta aplicación. Esta ubicación es una dirección del sitio web o una ruta de acceso de red y un nombre de archivo. Asegúrese de que los usuarios tengan acceso a esta ubicación.

La longitud máxima de toda la cadena es de 256 caracteres.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Application clase WMI de servidor.