Compartir a través de

Set-CMPackageDeployment

  • Referencia
Módulo:
ConfigurationManager

Cambia los valores que definen cómo Configuration Manager implementa un paquete de software.

Sintaxis

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-CMPackageDeployment cambia los valores que definen cómo Configuration Manager implementa un paquete de software. Una implementación incluye una colección de dispositivos o usuarios, un paquete para implementar y un nombre de programa de dispositivo o un nombre de programa estándar. Para especificar qué implementación se va a modificar, especifique el nombre de la colección, el paquete y el nombre del programa. Puede especificar el paquete por nombre o identificador, o bien puede usar el cmdlet Get-CMPackage para obtener un objeto de paquete.

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: Establecimiento de propiedades de periodicidad

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

Este comando realiza cambios en la implementación especificada por la colección denominada Todos los sistemas, el programa de dispositivo denominado DPM y el paquete denominado Herramienta de migración de estado de usuario para Windows 8. El comando establece el parámetro UseRecurrencePattern en un valor de $True. El comando especifica una unidad de repetición de horas y un valor de repetición de siete. Por lo tanto, la implementación se repite cada siete horas.

Ejemplo 2: Establecer día y hora de disponibilidad

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

Este comando realiza cambios en la implementación especificada por la colección denominada Todos los sistemas, el paquete denominado Herramienta de migración de estado de usuario para Windows 8 y el programa estándar denominado SPM. El comando especifica un día y una hora en que la implementación está disponible. El comando también especifica que la implementación no usa UTC para la programación de disponibilidad. La programación hace referencia a la zona horaria local.

Parámetros

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

Indica si los clientes usan contenido compartido. Si este valor es $True, los clientes intentan descargar contenido de otros clientes que descargaron ese contenido. Si este valor se $False, los clientes no intentan descargar desde otros clientes.

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

-Collection

Especifica la colección de usuarios.

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

-CollectionId

Especifica el identificador de un dispositivo o colección de usuarios.

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

-CollectionName

Especifica el identificador de un dispositivo o colección de usuarios.

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

-Comment

Especifica un comentario para la implementación.

Tipo:String
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeploymentAvailableDateTime

Especifica, como un objeto DateTime , la fecha y hora en que la implementación está disponible. Para obtener un objeto DateTime , use el cmdlet Get-Date .

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

-DeploymentExpireDateTime

Especifica, como un objeto DateTime , la fecha y hora en que expira la implementación. Para obtener un objeto DateTime , use el cmdlet Get-Date .

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

-DeploymentStartDateTime

Especifica, como un objeto DateTime , la fecha y hora en que se inicia la implementación. Para obtener un objeto DateTime , use el cmdlet Get-Date .

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

-DeviceProgramName

Especifica el nombre de un programa de dispositivo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
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

-EnableExpireSchedule

Indica si se va a habilitar la programación para que expire la implementación.

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

-FastNetworkOption

Especifica el comportamiento del cliente en una red rápida. Los valores aceptables para este parámetro son:

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Tipo:FastNetworkOptionType
Valores aceptados:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
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

-InputObject

Especifica un objeto de paquete.

Tipo:IResultObject
Alias:Package, DeploymentSummary, Advertisement
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PackageId

Especifica el identificador de un paquete.

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

-PackageName

Especifica el nombre de un paquete.

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

-PassThru

Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.

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

-PersistOnWriteFilterDevice

Indica si se deben habilitar los filtros de escritura para dispositivos incrustados. Para un valor de $True, el dispositivo confirma los cambios durante una ventana de mantenimiento. Esta acción requiere un reinicio. Para un valor de $False, el dispositivo guarda los cambios en una superposición y los confirma más adelante.

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

-RecurUnit

Especifica una unidad para una implementación periódica. Los valores aceptables para este parámetro son:

  • Días
  • Horas
  • Minutos
Tipo:RecurUnitType
Valores aceptados:Minutes, Hours, Days
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RecurValue

Especifica la frecuencia con la que se repite una implementación. Este parámetro depende del tipo de unidad especificado en el parámetro RecurUnit . Este valor puede estar entre 1 y 23 si la unidad es Horas, entre 1 y 31 si la unidad es Días, o entre 1 y 59 si la unidad es Minutos.

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

-Rerun

Indica si la implementación se vuelve a ejecutar. Si este valor se $True, la implementación se ejecuta de nuevo para los clientes, tal como se especifica en el parámetro RerunBehavior . Si este valor se $False, la implementación no se vuelve a ejecutar.

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

-RerunBehavior

Especifica cómo se vuelve a ejecutar una implementación en un cliente. Los valores aceptables para este parámetro son:

  • AlwaysRerunProgram. Vuelva a ejecutarse según lo programado, incluso si la implementación se realizó correctamente. Puede usar este valor para implementaciones periódicas.
  • NeverRerunDeployedProgram. No se vuelve a ejecutar, incluso si se produjo un error en la implementación o si los archivos cambiaron.
  • RerunIfFailedPreviousAttempt. Vuelva a ejecutar, según lo programado, si se produjo un error en la implementación en el intento anterior.
  • RerunIfSucceededOnpreviousAttempt. Vuelva a ejecutar solo si el intento anterior se realizó correctamente. Puede usar este valor para las actualizaciones que dependen de la actualización anterior.
Tipo:RerunBehaviorType
Valores aceptados:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunFromSoftwareCenter

Indica si se va a ejecutar desde el centro de software.

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

-Schedule

Especifica un objeto CMSchedule . La programación especifica cuándo se produce la ventana de mantenimiento. Para crear un objeto CMSchedule , 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

-ScheduleEvent

Especifica una matriz de tipos de eventos de programación. Los valores aceptables para este parámetro son:

  • AsSoonAsPossible
  • Cerrar sesión
  • LogOn
  • SendWakeUpPacket
Tipo:ScheduleEventType[]
Valores aceptados:AsSoonAsPossible, LogOn, LogOff
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SendWakeupPacket

Indica si se va a enviar un paquete de reactivación a los equipos antes de que comience la implementación. Si este valor se $True, Configuration Manager reactiva un equipo de suspensión. Si este valor está $False, no reactiva los equipos de suspensión. Para que los equipos se activen, primero debe configurar Wake On LAN.

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

-SlowNetworkOption

Especifica cómo Configuration Manager implementa este paquete en una red lenta. Los valores aceptables para este parámetro son:

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Tipo:SlowNetworkOptionType
Valores aceptados:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SoftwareInstallation

Indica si se va a instalar el software implementado fuera de las ventanas de mantenimiento. Una ventana de mantenimiento es un período de tiempo especificado que se usa para el mantenimiento y las actualizaciones del equipo. Si este valor se $True, Configuration Manager instala el software según la programación, incluso si la programación se encuentra fuera de una ventana de mantenimiento. Si este valor se $False, Configuration Manager no instala software implementado fuera de ninguna ventana, pero espera una ventana de mantenimiento.

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

-StandardProgramName

Especifica un nombre de programa estándar.

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

-SystemRestart

Indica si un sistema se reinicia fuera de una ventana de mantenimiento. Una ventana de mantenimiento es un período de tiempo especificado que se usa para el mantenimiento y las actualizaciones del equipo. Si este valor es $True, cualquier reinicio necesario tiene lugar sin tener en cuenta las ventanas de mantenimiento. Si este valor se $False, el equipo no se reinicia fuera de una ventana de mantenimiento.

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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

Indica si se debe usar un patrón de periodicidad.

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

-UseUtc

Indica si se debe usar la hora universal coordinada (UTC), también conocida como hora media de Greenwich. Si este valor es $True, Configuration Manager usa UTC para esta implementación. Si este valor es $False, Configuration Manager usa la hora local.

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

-UseUtcForAvailableSchedule

Indica si se va a usar UTC para la programación disponible. Si este valor es $True, Configuration Manager usa UTC. Si este valor es $False, Configuration Manager usa la hora local.

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

-UseUtcForExpireSchedule

Indica si se debe usar UTC para la programación de expiración. Si este valor es $True, Configuration Manager usa UTC. Si este valor es $False, Configuration Manager usa la hora local.

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