Set-CMApplicationGroup

  • Referencia
Módulo:
ConfigurationManager

Configure un grupo de aplicaciones existente.

Sintaxis

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 los valores de un grupo de aplicaciones existente. 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.

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: 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 cambiarle el 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

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

-AddAppCategory

Especifique uno o varios objetos de categoría administrativa para ayudarle a filtrar y buscar 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 .

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

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

-AddUserCategory

Especifique uno o varios objetos de categoría de usuario para ayudarle a filtrar y buscar 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 .

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

-ApplyToLanguageById

Para la configuración que se muestra 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 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.

Por ejemplo, para agregar un nombre de aplicación localizado para Irlandés (Irlanda):

-ApplyToLanguageById 2108 -LocalizedName "Fáilte romhat"

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

-CleanAppCategory

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

Tipo:SwitchParameter
Alias:CleanAppCategories
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:SwitchParameter
Alias:CleanUserCategories
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:SwitchParameter
Alias:ClearAppCatalogs, CleanAppCatalog, CleanAppCatalogs
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ClearOwner

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

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

-ClearSupportContact

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

Tipo:SwitchParameter
Alias:CleanSupportContacts
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

-Id

Especifique el identificador del grupo de aplicaciones que se va a configurar. Este valor es el mismo que el CI_ID, por ejemplo 1025866.

Tipo:Int32
Alias:CIId, CI_ID
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InputObject

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

Tipo:IResultObject
Alias:ApplicationGroup
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
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

-ModelName

Especifique el identificador del modelo de aplicación del grupo de aplicaciones que se va a 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.

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

-Name

Especifique el nombre del grupo de aplicaciones que se va a configurar.

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

-NewName

Use este parámetro para cambiar el nombre del grupo de aplicaciones. 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

-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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

Tipo:SwitchParameter
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

-RemoveAppCatalog

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

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.

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

-RemoveAppCatalog 2108

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

-RemoveAppCategoryName

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

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

-RemoveApplication

Especifique una matriz de nombres de aplicación que se van a quitar de este grupo.

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

-RemoveOwner

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

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

-RemoveSupportContact

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

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

-RemoveUserCategoryName

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

Tipo:String[]
Alias:RemoveUserCategoryNames
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject

Este cmdlet devuelve el SMS_ApplicationGroup objeto de clase WMI.