Set-CMPackageDeployment
Cambia los valores que definen cómo Configuration Manager implementa un paquete de software.
Syntax
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 Configuration Manager, por ejemploPS 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 $TrueEste 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 $FalseEste 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 }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Especifica la colección de usuarios.
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Especifica el identificador de un dispositivo o colección de usuarios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Especifica el identificador de un dispositivo o colección de usuarios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
Especifica un comentario para la implementación.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
Especifica el nombre de un programa de dispositivo.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableExpireSchedule
Indica si se va a habilitar la programación para que expire la implementación.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FastNetworkOption
Especifica el comportamiento del cliente en una red rápida. Los valores aceptables para este parámetro son:
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| Type: | FastNetworkOptionType |
| Accepted values: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Especifica un objeto de paquete.
| Type: | IResultObject |
| Aliases: | Package, DeploymentSummary, Advertisement |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PackageId
Especifica el identificador de un paquete.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Especifica el nombre de un paquete.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurUnit
Especifica una unidad para una implementación periódica. Los valores aceptables para este parámetro son:
- Días
- Horas
- Minutos
| Type: | RecurUnitType |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 han cambiado.
- 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.
| Type: | RerunBehaviorType |
| Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromSoftwareCenter
Indica si se va a ejecutar desde el centro de software.
| Type: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleEvent
Especifica una matriz de tipos de eventos de programación. Los valores aceptables para este parámetro son:
- AsSoonAsPossible
- Cerrar sesión
- Sesión
- SendWakeUpPacket
| Type: | ScheduleEventType[] |
| Accepted values: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
| Type: | SlowNetworkOptionType |
| Accepted values: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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, el Configuration Manager instala software según la programación, incluso si la programación se encuentra fuera de una ventana de mantenimiento. Si este valor es $False, Configuration Manager no instala software implementado fuera de ninguna ventana, pero espera una ventana de mantenimiento.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
Especifica un nombre de programa estándar.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseRecurrencePattern
Indica si se debe usar un patrón de periodicidad.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtc
Indica si se debe usar la hora universal coordinada (UTC), también conocida como hora media de Greenwich. Si este valor se $True, Configuration Manager usa UTC para esta implementación. Si este valor es $False, Configuration Manager usa la hora local.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de