Set-CMApplicationGroup

Módulo:

ConfigurationManager

Configurar un grupo de aplicaciones existente.

Syntax

Set-CMApplicationGroup
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Id] <Int32>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   -ModelName <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMApplicationGroup
   [-Name] <String>
   [-NewName <String>]
   [-Description <String>]
   [-Publisher <String>]
   [-SoftwareVersion <String>]
   [-OptionalReference <String>]
   [-AddAppCategory <IResultObject[]>]
   [-RemoveAppCategoryName <String[]>]
   [-CleanAppCategory]
   [-ReleaseDate <DateTime>]
   [-AddOwner <String[]>]
   [-RemoveOwner <String[]>]
   [-ClearOwner]
   [-AddSupportContact <String[]>]
   [-RemoveSupportContact <String[]>]
   [-ClearSupportContact]
   [-AddAppCatalog <AppDisplayInfo[]>]
   [-RemoveAppCatalog <Int32[]>]
   [-ClearAppCatalog]
   [-DefaultLanguageId <Int32>]
   [-ApplyToLanguageById <Int32>]
   [-LocalizedName <String>]
   [-AddUserCategory <IResultObject[]>]
   [-RemoveUserCategoryName <String[]>]
   [-CleanUserCategory]
   [-UserDocumentation <String>]
   [-LinkText <String>]
   [-PrivacyUrl <String>]
   [-LocalizedDescription <String>]
   [-Keyword <String[]>]
   [-IconLocationFile <String>]
   [-AddApplication <String[]>]
   [-RemoveApplication <String[]>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar la configuración de un grupo de aplicaciones existente. Usa un grupo de aplicaciones para implementar varias aplicaciones en una colección como una sola implementación. Los metadatos que especifiques sobre el grupo de aplicaciones se ven en el Centro de software como una sola entidad. Puedes ordenar las aplicaciones del grupo para que el cliente las instale en un orden específico. Para obtener más información, vea Create application groups.

Nota

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

Ejemplos

Ejemplo 1: Cambiar el nombre de un grupo de aplicaciones

En este ejemplo se obtiene un objeto para el grupo de aplicaciones y se pasa a este cmdlet para cambiar su nombre.

$appgroup = Get-CMApplicationGroup -Name "Central app"
Set-CMApplicationGroup -InputObject $appgroup -NewName "Contoso Central App"

Ejemplo 2: Agregar un nombre localizado

En este ejemplo se configura el grupo de aplicaciones con un nombre de aplicación localizado para el idioma irlandés.

Set-CMApplicationGroup -Name "Contoso Welcome app" -ApplyToLanguageById 60 -LocalizedName "Fáilte romhat"

Parámetros

- Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddAppCatalog

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[]
Aliases:	AppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddAppCategory

Especifica uno o varios objetos de categoría administrativa para ayudarte a filtrar y encontrar el grupo de aplicaciones en la consola. Para obtener estos objetos, use el cmdlet Get-CMCategory. Estas categorías son de tipo AppCategories.

Para agregar categorías para ayudar a los usuarios a filtrar y buscar aplicaciones en el Centro de software, use el parámetro AddUserCategory.

Type:	IResultObject[]
Aliases:	AddAppCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddApplication

Especifique una matriz de cadenas de nombres de aplicación para agregar al grupo. Si ya tienes 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[]
Aliases:	AddApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddOwner

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

Type:	String[]
Aliases:	AddOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String[]
Aliases:	AddSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddUserCategory

Especifica uno o varios objetos de categoría de usuario para ayudarte a filtrar y encontrar el grupo de aplicaciones en la consola. Para obtener estos objetos, use el cmdlet Get-CMCategory. Estas categorías son de tipo CatalogCategories.

Para agregar categorías para ayudar a los usuarios a filtrar y buscar aplicaciones en el Centro de software, use el parámetro AddAppCategory.

Type:	IResultObject[]
Aliases:	AddUserCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplyToLanguageById

Para las opciones que se muestran en el Centro de software, use este parámetro para especificar el identificador de idioma de la configuración.

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

Por ejemplo, para agregar un nombre de aplicación localizado para Irlanda :

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

Type:	Int32
Aliases:	ApplySettingToSpecificLanguage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CleanAppCategory

Agregue este parámetro para quitar todas las categorías administrativas. Para quitar una sola categoría, use el parámetro RemoveAppCategory.

Type:	SwitchParameter
Aliases:	CleanAppCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CleanUserCategory

Agregue este parámetro para quitar todas las categorías de usuario. Para quitar una sola categoría, use el parámetro RemoveUserCategory.

Type:	SwitchParameter
Aliases:	CleanUserCategories
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearAppCatalog

Agregue este parámetro para quitar todas las entradas localizadas del Centro de software. Para quitar una sola entrada, use el parámetro RemoveAppCatalog.

Type:	SwitchParameter
Aliases:	ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearOwner

Agregue este parámetro para quitar todos los propietarios. Para quitar un único propietario, use el parámetro RemoveOwner.

Type:	SwitchParameter
Aliases:	CleanOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearSupportContact

Agregue este parámetro para quitar todos los contactos de soporte técnico. Para quitar un solo contacto, use el parámetro RemoveSupportContact.

Type:	SwitchParameter
Aliases:	CleanSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultLanguageId

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

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

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

-Description

Especifica un comentario de administrador opcional para el grupo de aplicaciones. La longitud máxima es de 2048 caracteres.

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

-ForceWildcardHandling

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

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

-IconLocationFile

Especifica 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 512x512. El archivo puede ser de los siguientes tipos de archivo de imagen e icono:

• DLL
• EXE
• JPG
• ICO
• PNG

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

-Id

Especifica el identificador del grupo de aplicaciones que se debe configurar. Este valor es el mismo que el CI_ID, por ejemplo 1025866 .

Type:	Int32
Aliases:	CIId, CI_ID
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Especifique un objeto de grupo de aplicaciones que se debe configurar. Para obtener este objeto, use el cmdlet Get-CMApplicationGroup.

Type:	IResultObject
Aliases:	ApplicationGroup
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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.

Type:	String[]
Aliases:	Keywords
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. Se permite una longitud máxima de 128 caracteres.

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

-LocalizedDescription

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

Type:	String
Aliases:	LocalizedAppGroupDescription
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-LocalizedName

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

-ModelName

Especifica el identificador del modelo de aplicación del grupo de aplicaciones que se debe configurar. Este valor también se conoce como identificador único de CI. Por ejemplo, ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/ApplicationGroup_047fbf05-55f4-42ab-9581-e63fd0337fed.

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

-Name

Especifica el nombre del grupo de aplicaciones que se debe configurar.

Type:	String
Aliases:	LocalizedDisplayName, ApplicationGroupName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Usa este parámetro para cambiar el nombre del grupo de aplicaciones. La longitud máxima es de 256 caracteres.

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

-OptionalReference

Especifica una cadena opcional para ayudarte a encontrar el grupo de aplicaciones en la consola. La longitud máxima es de 256 caracteres.

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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, es posible que este cmdlet no genere ningún resultado.

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

-PrivacyUrl

Especifica una dirección de sitio web a 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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Publisher

Especifica información de proveedor opcional para este grupo de aplicaciones. La longitud máxima es de 256 caracteres.

Type:	String
Aliases:	Manufacturer
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ReleaseDate

Especifica un objeto date para cuándo se publicó este grupo de aplicaciones. Para obtener este objeto, use el cmdlet integrado Get-Date.

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

-RemoveAppCatalog

Especifique una matriz de IDs de idioma para quitar las entradas asociadas del Centro de software. Para quitar todas las entradas, use el parámetro ClearAppCatalog.

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

Por ejemplo, para quitar la entrada localizada del Centro de software para Irlanda (Irlanda):

-RemoveAppCatalog 2108

Type:	Int32[]
Aliases:	RemoveAppCatalogsByLanguageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveAppCategoryName

Especifique una matriz de nombres de categorías administrativas que se quitarán. Para quitar todas las categorías administrativas, use el parámetro CleanAppCategory.

Type:	String[]
Aliases:	RemoveAppCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveApplication

Especifique una matriz de nombres de aplicación para quitar de este grupo.

Type:	String[]
Aliases:	RemoveApplications
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveOwner

Especifique una matriz de propietarios que se quitará. Para quitar todos los propietarios, use el parámetro ClearOwner.

Type:	String[]
Aliases:	RemoveOwners
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSupportContact

Especifique una matriz de contactos de soporte técnico que se quitarán. Para quitar todos los contactos de soporte técnico, use el parámetro ClearSupportContact.

Type:	String[]
Aliases:	RemoveSupportContacts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUserCategoryName

Especifique una matriz de nombres de categorías de usuario que se quitarán. Para quitar todas las categorías de usuario, use el parámetro CleanUserCategory.

Type:	String[]
Aliases:	RemoveUserCategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftwareVersion

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

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

-UserDocumentation

Especifica 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 una ruta de acceso de red y un nombre de archivo. Asegúrese de que los usuarios tienen acceso a esta ubicación.

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject

Este cmdlet devuelve el SMS_ApplicationGroup de clase WMI.

Vínculos relacionados

• Get-CMApplicationGroup
• New-CMApplicationGroup
• Remove-CMApplicationGroup
• New-CMApplicationDisplayInfo
• Get-CMApplicationGroupDeployment
• New-CMApplicationGroupDeployment
• Remove-CMApplicationGroupDeployment
• Set-CMApplicationGroupDeployment
• Crear grupos de aplicaciones