New-CMApplicationGroup

SINOPSIS

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 sola 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 en el grupo para que el cliente las instale en un orden específico. Para más información, consulte Crear grupos de aplicaciones.

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

Nota

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

EJEMPLOS

Ejemplo 1: crear 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'

PARAMETERS

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

Type: String[]
Parameter Sets: (All)
Aliases: AddApplications

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

-AddOwner

Especifique uno o más usuarios administrativos responsables de este grupo de aplicaciones.

Type: String[]
Parameter Sets: (All)
Aliases: AddOwners

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

-AddSupportContact

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

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportContacts

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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
  • Título
  • UserDocumentation

Para obtener este objeto, use el 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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DefaultLanguageId

Especifique el ID. de idioma para el idioma predeterminado del centro de software.

Este identificador es el decimal equivalente al 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 de identificador de idioma de Windows (LCID).

Type: Int32
Parameter Sets: (All)
Aliases:

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

- Description

Especifique un Comentario de administrador opcional para el grupo de aplicaciones. La longitud máxima es 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 los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-IconLocationFile

Especifique la ruta de acceso al archivo que contiene el icono de este grupo de aplicaciones. Los iconos pueden tener dimensiones de hasta 512 x 512 píxeles. El archivo puede tener los siguientes tipos de archivo de imagen e icono:

  • Archivo 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

-Keyword (palabra clave)

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.

Type: String[]
Parameter Sets: (All)
Aliases: Keywords

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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. La longitud máxima es de 128 caracteres.

Type: String
Parameter Sets: (All)
Aliases:

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

-LocalizedDescription

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

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

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

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

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

-Name

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

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

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

-OptionalReference

Especifique una cadena opcional que le ayude a encontrar el grupo de aplicaciones en la consola. La longitud máxima es de 256 caracteres.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: String
Parameter Sets: (All)
Aliases:

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

-Publisher

Especifique la información opcional del proveedor para este grupo de aplicaciones. La longitud máxima es 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 un objeto de fecha para el momento en que se liberó este grupo de aplicaciones. Para obtener este objeto, use el cmdlet integrado Get-Date .

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-SoftwareVersion

Especifique una cadena de versión opcional para el grupo de aplicaciones. La longitud máxima es de 64 caracteres.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 de sitio web o un nombre de archivo y de ruta de acceso de red. Asegúrese de que los usuarios tengan acceso a esta ubicación.

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

Type: String
Parameter Sets: (All)
Aliases:

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

-WhatIf

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Este cmdlet admite los parámetros comunes siguientes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, consulta about_CommonParameters.

ENTRADAS

Ninguno

SALIDAS

IResultObject # SMS_ApplicationGroup

NOTAS

Este cmdlet devuelve el objeto de clase WMI SMS_ApplicationGroup .

VÍNCULOS RELACIONADOS

Get-CMApplicationGroup Remove-CMApplicationGroup Set-CMApplicationGroup

New-CMApplicationDisplayInfo

Get-CMApplicationGroupDeployment New-CMApplicationGroupDeployment Remove-CMApplicationGroupDeployment Set-CMApplicationGroupDeployment

Crear grupos de aplicaciones