Compartir a través de

New-CMApplicationGroup

  • Referencia
Módulo:
ConfigurationManager

Cree un nuevo grupo de aplicaciones.

Sintaxis

New-CMApplicationGroup
   [-Name] <String>
   -AddApplication <String[]>
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-AddSupportContact <String[]>]
   [-AppGroupCatalog <AppDisplayInfo[]>]
   [-DefaultLanguageId <Int32>]
   [-LocalizedName <String>]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear un grupo de aplicaciones. Use un grupo de aplicaciones para implementar varias aplicaciones en una colección como una única implementación. Los metadatos que especifique sobre el grupo de aplicaciones se ven en el Centro de software como una sola entidad. Puede ordenar las aplicaciones del grupo para que el cliente las instale en un orden específico. Para obtener más información, consulte Creación de grupos de aplicaciones.

Hay algunas opciones de configuración de un grupo de aplicaciones que no se pueden configurar al crearlo. Para configurar otras opciones, use el cmdlet Set-CMApplicationGroup .

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 un grupo con dos aplicaciones

En este ejemplo se crea un nuevo grupo de aplicaciones denominado Aplicación central que incluye dos aplicaciones.

$apps = @('LOB Framework','CA UI')

New-CMApplicationGroup -Name 'Central app' -AddApplication $apps -Description 'Central app group' -Publisher 'Contoso IT' -SoftwareVersion '1.1.2' -ReleaseDate (Get-Date) -AddOwner 'jqpublic' -AddSupportContact 'jdoe' -LocalizedAppGroupName 'Central app'

Parámetros

-AddApplication

Especifique una matriz de cadenas de nombres de aplicación para agregar al grupo. Si ya tiene un objeto de aplicación de otro cmdlet como Get-CMApplication, este valor es la propiedad LocalizedDisplayName . Por ejemplo: $appList = @($app1.LocalizedDisplayName,$app2.LocalizedDisplayName)

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

-AddOwner

Especifique uno o varios usuarios administrativos responsables de este grupo de aplicaciones.

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

-AppGroupCatalog

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 el grupo de aplicaciones:

  • 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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:None
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 el grupo de aplicaciones. 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

-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 este grupo de aplicaciones. 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

-Keyword

Especifique una lista de palabras clave en el idioma seleccionado. Estas palabras clave ayudan a los usuarios del Centro de software a buscar el grupo de aplicaciones.

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 este grupo de aplicaciones en el idioma seleccionado. La longitud máxima es de 2048 caracteres.

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

-LocalizedName

Especifique el nombre del grupo de aplicaciones 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:LocalizedAppGroupName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique un nombre para el grupo de aplicaciones. La longitud máxima es de 256 caracteres.

Tipo:String
Alias:LocalizedDisplayName, ApplicationGroupName
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 el grupo de aplicaciones 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

-PrivacyUrl

Especifique una dirección de sitio web para la declaración de privacidad del grupo de aplicaciones. 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 este grupo de aplicaciones. 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ó este grupo de aplicaciones. 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 el grupo de aplicaciones. 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

-UserDocumentation

Especifique la ubicación de un archivo desde el que los usuarios del Centro de software pueden obtener más información sobre este grupo de aplicaciones. 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:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

IResultObject

Notas

Este cmdlet devuelve el SMS_ApplicationGroup objeto de clase WMI.