New-CMPackageDeployment

Implementar un paquete heredado en una colección.

Syntax

New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-Package] <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   -ProgramName <String>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-DeployPurpose <DeployPurposeType>]
   [-FastNetworkOption <FastNetworkOptionType>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-Program] <IResultObject>
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   [-StandardProgram]
   [-SystemRestart <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageName <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   -PackageId <String>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Package] <IResultObject>
   -ProgramName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMPackageDeployment
   [-DeployPurpose <DeployPurposeType>]
   [-DeviceProgram]
   [-Program] <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseUtc <Boolean>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-DeadlineDateTime <DateTime>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para implementar un paquete en los recursos de una colección. Puede especificar la colección por identificador, nombre o pase un objeto.

Para otras opciones de implementación que no puede configurar con este cmdlet, use Set-CMPackageDeployment.

Para obtener más información, vea Paquetes y programas en Configuration Manager.

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: Implementar un paquete por identificador

Este comando crea una implementación del paquete con id. XYZ00001 en la colección con ID XYZ0003F.

$pkgId = "XYZ00001"
$collId = "XYZ0003F"
New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName "ScanState" -CollectionID $collId -Comment "Use USMT to scan for data" -DeployPurpose Available

Ejemplo 2: Implementar un paquete según sea necesario con una fecha límite

El primer comando establece una variable para una fecha límite en 10 días a partir de ahora a las 8:00 p.m. El segundo comando crea un objeto de programación basado en esa fecha límite que se repite diariamente. El tercer comando crea la implementación del paquete con esa programación.

[datetime]$DeadlineTime = (Get-Date -Hour 20 -Minute 0 -Second 0).AddDays(10)

$NewScheduleDeadline = New-CMSchedule -Start $DeadlineTime -Nonrecurring

$pkgId = "XYZ00001"
$progName = "Run"
$collId = "XYZ0003F"

New-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName $progName -DeployPurpose Required -CollectionId $collId -FastNetworkOption DownloadContentFromDistributionPointAndRunLocally -SlowNetworkOption DownloadContentFromDistributionPointAndLocally -RerunBehavior RerunIfFailedPreviousAttempt -Schedule $NewScheduleDeadline

Parámetros

-AllowFallback

Permitir que los clientes usen puntos de distribución del grupo de límites de sitio predeterminado.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AllowSharedContent

Permitir que los clientes usen puntos de distribución de un grupo de límites de vecinos.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-AvailableDateTime

Especifique cuándo está disponible esta implementación.

Use -DeadlineDateTime para especificar cuándo expira la implementación y -Schedule para especificar la asignación de implementación o la fecha límite.

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

-Collection

Especifique un objeto de colección como destino para esta implementación de paquetes. Para obtener este objeto, use el cmdlet Get-CMCollection.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionId

Especifique un identificador de colección como destino para esta implementación de paquete.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Especifique un nombre de colección como destino para esta implementación de paquetes.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-Comment

Especifique un comentario opcional para esta implementación de paquete.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Agregue este parámetro para solicitar confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeadlineDateTime

Use este parámetro para especificar cuándo expira la implementación.

Use -AvailableDateTime para especificar cuándo está disponible la implementación y -Schedule para especificar la asignación de implementación o la fecha límite.

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

-DeployPurpose

Especifique si esta implementación está disponible para que los usuarios se instalen o si es necesario instalarla en la fecha límite.

Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceProgram

Si el programa del paquete que está implementando es un programa de tipo dispositivo, especifique este parámetro.

De lo contrario, use el parámetro StandardProgram. El tipo de programa estándar es para equipos con el cliente de Configuration Manager.

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

-DistributeCollectionName

El sitio distribuye contenido a los grupos de puntos de distribución asociados con este nombre de colección.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributeContent

Agregue este parámetro para distribuir el contenido del paquete al crear esta implementación. Los clientes no pueden instalar el paquete hasta que distribuya contenido a los puntos de distribución a los que pueden tener acceso los clientes.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupName

El sitio distribuye contenido a este grupo de puntos de distribución.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointName

El sitio distribuye contenido a este punto de distribución.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FastNetworkOption

Especifique el comportamiento cuando el cliente usa un punto de distribución del grupo de límites actual:

  • Ejecutar programa desde el punto de distribución
  • Descargar contenido desde el punto de distribución y ejecutarse localmente

Si no especifica este parámetro, lo usa DownloadContentFromDistributionPointAndRunLocally de forma predeterminada. Esta opción es más segura, ya que el cliente valida el hash de contenido antes de que ejecute el programa.

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

Especifique un objeto de paquete con el programa que se implementará. Para obtener este objeto, use el cmdlet Get-CMPackage.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

Especifique el identificador del paquete con el programa que se implementará. Este identificador es un identificador de paquete estándar, por ejemplo XYZ007E3 .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PackageName

Especifique el nombre del paquete con el programa que se implementará.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PersistOnWriteFilterDevice

Configure el modo en que el cliente controla el filtro de escritura Windows dispositivos incrustados.

  • $true: confirme los cambios en la fecha límite o durante una ventana de mantenimiento. Se requiere un reinicio.
  • $false: aplique contenido en la superposición y confirme más adelante.
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Program

Especifique un objeto de programa que se implementará. Para obtener este objeto, use el cmdlet Get-CMProgram.

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProgramName

Especifique el nombre del programa en el paquete que se implementará.

Type:String
Aliases:StandardProgramName, DeviceProgramName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurUnit

Especifique una unidad para una implementación periódica. Use el parámetro RecurValue para especificar el valor de esta unidad.

Type:RecurUnitType
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurValue

Especifique la frecuencia con la que se repite la implementación.

Este parámetro depende del tipo de unidad especificado en el parámetro RecurUnit:

  • Horas: este valor puede estar entre 1 y 23
  • Días: Entre 1 y 31
  • Minutos: Entre 1 y 59
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:

  • $True: la implementación se ejecuta de nuevo para los clientes, tal como se especifica en el parámetro RerunBehavior. Este valor es el predeterminado.
  • $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

Especifique si el programa se vuelve a ejecutar en un equipo.

  • NeverRerunDeployedProgram: no se vuelve a ejecutar, incluso si la implementación ha fallado o los archivos han cambiado.
  • AlwaysRerunProgram: Vuelva a ejecutar como está programado, incluso si la implementación se ha hecho correctamente. Puede usar este valor para implementaciones periódicas. Este valor es el predeterminado.
  • RerunIfFailedPreviousAttempt: vuelva a ejecutar como estaba programado, si la implementación no se pudo realizar en el intento anterior.
  • RerunIfSucceededOnPreviousAttempt: Vuelva a ejecutarse solo si el intento anterior se ha intentado correctamente.
Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunFromSoftwareCenter

Permitir que los usuarios ejecuten el programa independientemente de las asignaciones.

Type:Boolean
Aliases:AllowUsersRunIndependently
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Use este parámetro para especificar la asignación de implementación o la fecha límite.

Use -AvailableDateTime para especificar cuándo está disponible la implementación y -DeadlineDateTime para especificar cuándo expira la implementación.

Especifique una matriz de objetos de programación. Un objeto schedule define la programación de asignación obligatoria para una implementación. Para crear un objeto schedule, use el cmdlet New-CMSchedule.

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleEvent

Especifique el tipo de evento que determina cuándo se ejecuta la implementación del paquete.

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 , no reactiva $False los equipos del estado de suspensión. Para que los equipos se activen, primero configure Wake on LAN.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SlowNetworkOption

Especifique el comportamiento cuando el cliente usa un punto de distribución de un grupo de límites de vecinos o el grupo de límites de sitio predeterminado:

  • No ejecutar programa
  • Descargar contenido desde el punto de distribución y ejecutarse localmente
  • Ejecutar programa desde el punto de distribución

Si no especifica este parámetro, lo usa DoNotRunProgram de forma predeterminada.

Type:SlowNetworkOptionType
Accepted values:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

Cuando se alcance la fecha límite de instalación, establezca este parámetro para permitir que el paquete se $true instale fuera de la ventana de mantenimiento.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StandardProgram

Use este parámetro para tipos de programa estándar. Este tipo es para equipos con el cliente de Configuration Manager.

Si el programa del paquete que estás implementando es un programa de tipo dispositivo, usa el parámetro DeviceProgram.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SystemRestart

Cuando se alcance la fecha límite de instalación, establezca este parámetro para permitir el reinicio del sistema si $true es necesario fuera de la 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 de una conexión a Internet con medición descarguen contenido después de la fecha límite de instalación, lo que podría conllevar más costos.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtc

Indica si los clientes usan la hora universal coordinada (UTC) para determinar la disponibilidad de un programa. La hora UTC hace que la implementación esté disponible al mismo tiempo para todos los equipos. Si no especifica este parámetro o lo establece en $false , el cliente usa su hora local.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForAvailableSchedule

Indica si los clientes usan la hora universal coordinada (UTC) para determinar la disponibilidad de un programa. La hora UTC hace que la implementación esté disponible al mismo tiempo para todos los equipos. Si no especifica este parámetro o lo establece en $false , el cliente usa su hora local.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForExpireSchedule

Indica si los clientes usan la hora universal coordinada (UTC) para determinar cuándo ha expirado un programa. La hora UTC expira la implementación al mismo tiempo para todos los equipos. Si no especifica este parámetro o lo establece en $false , el cliente usa su 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:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object