Start-CMPackageDeployment
(En desuso) Inicia la implementación de un paquete de software en una colección de Configuration Manager.
Syntax
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
[-Package] <IResultObject>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
-ProgramName <String>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
[-AllowSharedContent <Boolean>]
-CollectionName <String>
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-FastNetworkOption <FastNetworkOptionType>]
[-PassThru]
[-PersistOnWriteFilterDevice <Boolean>]
[-Program] <IResultObject>
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
[-StandardProgram]
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
-PackageName <String>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
-PackageId <String>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
[-Package] <IResultObject>
[-PassThru]
-ProgramName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Start-CMPackageDeployment
-CollectionName <String>
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
[-DeploymentStartDay <DateTime>]
[-DeploymentStartTime <DateTime>]
[-DeployPurpose <DeployPurposeType>]
[-DeviceProgram]
[-PassThru]
[-Program] <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtc <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Importante
Este cmdlet está en desuso. Use New-CMPackageDeployment en su lugar.
El cmdlet Start-CMPackageDeployment inicia la implementación de un paquete de software especificado en equipos que pertenecen a una colección de Configuration Manager. Puede elegir cuándo está disponible el paquete y cuándo expira la implementación del paquete. Puede especificar si Configuration Manager implementa el paquete solo una o varias veces y qué sucede cuando se produce un error en la instalación de un equipo.
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: Iniciar una implementación periódica
PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True
Este comando inicia la implementación de un paquete con nombre en la colección denominada Todos los sistemas para el programa de dispositivo denominado DPM. El comando especifica un día de inicio y una hora de inicio. El comando incluye un comentario descriptivo. El parámetro Rerun tiene un valor de $True y el comando especifica un valor recur de siete y una unidad recursiva de Days, por lo que la implementación se vuelve a ejecutar cada siete días. La implementación usa una red medida. La implementación usa la hora UTC.
Ejemplo 2: Iniciar una implementación periódica para un paquete disponible
PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True
Este comando inicia la implementación de un paquete con nombre en la colección denominada Western Computers para el programa de dispositivos denominado DPM. El comando incluye un comentario descriptivo. El comando especifica Available como DeployPurpose, por lo que los usuarios pueden decidir si instalar este software. El parámetro Rerun tiene un valor de $True. La implementación usa la hora UTC.
Ejemplo 3: Iniciar una implementación para un programa estándar
PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False
Este comando inicia una implementación de un paquete denominado Herramienta de migración de estado de usuario para Windows 8 a la colección denominada Todos los sistemas para el programa estándar denominado SPM. El comando no permite que los equipos usen contenido compartido.
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | 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 es $False, los clientes no intentan descargar desde otros clientes.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comment
Especifica un comentario para la implementación.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDay
Obsoleto. Use DeploymentAvailableDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableTime
Obsoleto. Use DeploymentAvailableDateTime en su lugar.
Type: | DateTime |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDay
Obsoleto. Use DeploymentExpireDateTime en su lugar.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireTime
Obsoleto. Use DeploymentExpireDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentStartDay
Obsoleto. Use DeploymentStartDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentStartTime
Obsoleto. Use DeploymentStartDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Especifica el propósito de la implementación. Los valores aceptables para este parámetro son:
- Disponible
- Obligatorio
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgram
Especifica un programa de dispositivo.
Type: | SwitchParameter |
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 |
-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 |
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 |
-Package
Especifica un objeto package. Para obtener un objeto package, use el cmdlet Get-CMPackage.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PackageId
Especifica el identificador de un paquete.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Especifica el nombre de un paquete.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica si se habilitarán 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Program
Especifica un programa.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProgramName
Especifica el nombre de un programa.
Type: | String |
Aliases: | StandardProgramName, DeviceProgramName |
Position: | Named |
Default value: | None |
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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Rerun
Indica si la implementación se vuelve a ejecutar. Si este valor es $True, la implementación se ejecuta de nuevo para los clientes como se especifica en el parámetro RerunBehavior. Si este valor es $False, la implementación no se vuelve a ejecutar.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 ejecutar como está programado, incluso si la implementación se ha hecho correctamente. Puede usar este valor para implementaciones periódicas.
- NeverRerunDeployedProgram. No se vuelve a ejecutar, incluso si la implementación ha fallado o los archivos han cambiado.
- RerunIfFailedPreviousAttempt. Vuelva a ejecutar, como estaba programado, si la implementación no se pudo realizar en el intento anterior.
- RerunIfSucceededOnpreviousAttempt. Vuelva a ejecutar solo si el intento anterior se ha intentado correctamente. Puede usar este valor para las actualizaciones que dependen de la actualización anterior.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Especifica un objeto de programación para la implementación.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
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
- LogOff
- LogOn
- SendWakeUpPacket
Type: | ScheduleEventType |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica si se debe enviar un paquete de activación a los equipos antes de que comience la implementación. Si este valor es $True, Configuration Manager reactiva un equipo de suspensión. Si este valor es $False, no reactiva los equipos del estado de suspensión. Para que los equipos se activen, primero debe configurar Wake on LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Indica si se debe 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 es $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 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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgram
Indica que el tipo de programa del paquete de implementación es un programa estándar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
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 es $False, el equipo no se reinicia fuera de una ventana de mantenimiento.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica si se permite que los clientes descarguen contenido a través de una conexión a Internet con contador después de la fecha límite, lo que puede incurrir en gastos adicionales.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Indica si se va a 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Indica si se va a 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 |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
System.Object