Set-CMPackage

Modificar un paquete.

Sintaxis

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-InputObject] <IResultObject>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para cambiar la configuración de un paquete. Para obtener más información, vea Paquetes y programas 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: Cambiar el nombre de un paquete y agregar una descripción

Este comando cambia el nombre del paquete que tiene el identificador ST120001 a ScriptsPackage02 y agrega una descripción.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Ejemplo 2: Cambio de la ruta de acceso de origen del paquete

El primer comando obtiene el paquete que tiene el identificador ST120001 y almacena los resultados en la variable $Pkg . El segundo comando cambia la ruta de acceso de origen del paquete.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

Parámetros

-Confirm

Agregue este parámetro para solicitar confirmación antes de que se ejecute 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

-CopyToPackageShareOnDistributionPoint

Los clientes siempre pueden descargar un paquete desde un punto de distribución. Si establece este parámetro en $true, el sitio lo pone a disposición a través de un recurso compartido de red con nombre en puntos de distribución. Use CustomPackageShareName para especificar un nombre de recurso compartido personalizado.

Al habilitar esta opción, se requiere más espacio en los puntos de distribución. Se aplica a todos los puntos de distribución a los que se distribuye este paquete.

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

-CustomPackageShareName

Si habilita CopyToPackageShareOnDistributionPoint, puede usar este parámetro para personalizar el nombre del recurso compartido. La longitud máxima es de 127 caracteres y no puede incluir ninguno de los siguientes caracteres: " / [ ] : | < > + = ; , ? *. Puede especificar un nombre de recurso compartido y un nombre de carpeta, pero el máximo para cada uno es de 80 caracteres. Por ejemplo, ShareName\FolderName.

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

-Description

Especifique una descripción opcional del paquete para ayudarle a identificarlo. Puede usar un máximo de 128 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

-DisconnectUserFromDistributionPoint

Esta opción está en desuso. Establece la propiedad ForcedDisconnectEnabled del paquete del controlador.

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

-DisconnectUserFromDistributionPointMins

Esta opción está en desuso. Establece la propiedad ForcedDisconnectDelay del paquete de controladores.

Tipo:UInt32
Alias:ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisconnectUserFromDistributionPointRetry

Esta opción está en desuso. Establece la propiedad ForcedDisconnectNumRetries del paquete del controlador.

Tipo:UInt32
Alias:ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DistributionPointUpdateSchedule

Use este parámetro para actualizar los puntos de distribución según una programación. Para obtener un objeto de programación, use el cmdlet New-CMSchedule .

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

-EnableBinaryDeltaReplication

Establezca este parámetro en $true para habilitar la replicación diferencial binaria (BDR). Para obtener más información, consulte Conceptos fundamentales para la administración de contenido en Configuration Manager.

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

-Id

Especifique el identificador de un paquete que se va a configurar. Este valor es un identificador de paquete estándar, por ejemplo: XYZ00020.

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

-InputObject

Especifique un objeto de paquete que se va a configurar. Para obtener este objeto, use el cmdlet Get-CMPackage .

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

-Language

Especifique una cadena de idioma para el paquete. Puede usar un máximo de 32 caracteres en un formato que elija usar para identificar la versión del idioma. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version . Por ejemplo, puede tener una versión en inglés y una versión en alemán del mismo paquete.

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

-Manufacturer

Especifique el nombre del fabricante para el software. Puede usar un máximo de 32 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .

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

-MifFileName

Especifique el nombre del archivo de formato de información de administración (MIF) que contiene el estado del paquete. La extensión de nombre de archivo debe ser .mif. Use un archivo MIF de estado para generar informes de estado detallados. Para generar un archivo MIF de estado, la aplicación debe llamar a la función InstallStatusMIF. Para obtener más información, vea Funciones de MIF de estado.

Si establece este parámetro, cuando el cliente ejecuta la implementación, el cliente de Configuration Manager busca en el %TEMP% directorio o en el %windir% directorio el archivo MIF de estado de instalación que especifique. El estado de instalación indica si el programa se ejecutó correctamente.

Si el cliente no encuentra el archivo, busca todos los archivos MIF en esos directorios. Realiza una comparación sin distinción entre mayúsculas y minúsculas de los valores especificados para MifName, MifPublisher y MifVersion con los valores especificados por el archivo MIF. Si el cliente encuentra una coincidencia, usa el estado que especifica el archivo MIF como estado de instalación del programa. Si no encuentra una coincidencia o no especifica MifFileName, el cliente usa el código de salida del programa para establecer el estado de instalación del programa. Un código de salida de cero indica que el programa se ejecutó correctamente. Cualquier otro valor indica códigos de error específicos de la aplicación.

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

-MifName

Especifique el nombre del paquete para la coincidencia de MIF, hasta 50 caracteres. Para obtener más información, vea el parámetro MifFileName .

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

-MifPublisher

Especifique el publicador de software del paquete para la coincidencia de MIF, hasta 32 caracteres. Para obtener más información, vea el parámetro MifFileName .

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

-MifVersion

Especifique el número de versión del paquete para la coincidencia de MIF, hasta 32 caracteres. Para obtener más información, vea el parámetro MifFileName .

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

-MulticastAllow

Establezca este parámetro en $true para permitir que este paquete se transfiera a través de multidifusión. Para obtener más información, consulte Uso de multidifusión para implementar Windows a través de la red con Configuration Manager.

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

-MulticastEncrypt

Si habilita MulticastAllow, establezca este parámetro en $true para cifrar los paquetes de multidifusión.

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

-MulticastTransferOnly

Si habilita MulticastAllow, establezca este parámetro en $true para transferir solo este paquete de controladores a través de multidifusión.

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

-Name

Especifique un nombre de paquete. Puede usar un máximo de 250 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .

Tipo:String
Posición:Named
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 de un paquete.

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

-Path

Si el paquete contiene archivos de origen, especifique la ubicación de los archivos. Puede especificar una ruta de acceso local completa en el servidor de sitio o una ruta de acceso de red. Asegúrese de que esta ubicación contiene todos los archivos y subdirectorios que el programa necesita ejecutar, incluidos los scripts.

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

-PersistContentInCache

Si no desea que el contenido de este paquete se agote de la memoria caché del cliente para dejar espacio a otro contenido, establezca este parámetro en $true conservarlo en la memoria caché del cliente.

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

-PrestageBehavior

Especifique el comportamiento al habilitar un punto de distribución para el contenido preconfigurado:

  • ManualCopy: copie manualmente el contenido de este paquete en el punto de distribución.
  • DownloadDelta: descargue solo los cambios de contenido en el punto de distribución.
  • OnDemand: descarga automática del contenido cuando se asignan paquetes a puntos de distribución

Para obtener más información, consulte Uso de contenido preconfigurado.

Tipo:PrestageBehavior
Valores aceptados:ManualCopy, DownloadDelta, OnDemand
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Priority

Especifique el orden en que el sitio envía el contenido a otros sitios y a los puntos de distribución de este sitio.

El sitio envía contenido de alta prioridad antes que los paquetes con prioridad normal o baja. Los paquetes con la misma prioridad se envían en el orden en que se crean.

Tipo:Priorities
Alias:DistributionPriority
Valores aceptados:High, Normal, Low
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SendToPreferredDistributionPoint

Si desea habilitar la distribución de contenido a petición en puntos de distribución preferidos, establezca este parámetro en $true. Al habilitar esta configuración, si un cliente solicita el contenido del paquete y el contenido no está disponible en ningún punto de distribución, el punto de administración distribuye el contenido. Para obtener más información, consulte Distribución de contenido a petición.

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

-Version

Especifique un número de versión para el software. La longitud máxima de esta cadena es de 32 caracteres. Para identificar un paquete, Configuration Manager usa los parámetros Language, Manufacturer, Name y Version .

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object