New-​CM​Package​Deployment

Creates a package deployment

Syntax

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

Description

{{Fill in the Description}}

Examples

Example 1

PS C:\> {{ Add example code here }}

{{ Add example description here }}

Required Parameters

-DeviceProgram

{{Fill DeviceProgram Description}}

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

{{Fill Package Description}}

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-PackageId

{{Fill PackageId Description}}

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

{{Fill PackageName Description}}

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

{{Fill Program Description}}

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ProgramName

{{Fill ProgramName Description}}

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

{{Fill StandardProgram Description}}

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

Optional Parameters

-AllowSharedContent

{{Fill AllowSharedContent Description}}

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

{{Fill AvailableDateTime Description}}

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Collection

{{Fill Collection Description}}

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

{{Fill CollectionId Description}}

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

{{Fill CollectionName Description}}

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

{{Fill Comment Description}}

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

Prompts you for confirmation before running the cmdlet.

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

{{Fill DeadlineDateTime Description}}

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeployPurpose

{{Fill DeployPurpose Description}}

Type:DeployPurposeType
Parameter Sets:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

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

{{Fill DistributeCollectionName Description}}

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

{{Fill DistributeContent Description}}

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

{{Fill DistributionPointGroupName Description}}

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

{{Fill DistributionPointName Description}}

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

{{Fill FastNetworkOption Description}}

Type:FastNetworkOptionType
Parameter Sets:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

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

{{Fill PersistOnWriteFilterDevice Description}}

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

{{Fill RecurUnit Description}}

Type:RecurUnitType
Parameter Sets:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecurValue

{{Fill RecurValue Description}}

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Rerun

{{Fill Rerun Description}}

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

{{Fill RerunBehavior Description}}

Type:RerunBehaviorType
Parameter Sets:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunFromSoftwareCenter

{{Fill RunFromSoftwareCenter Description}}

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

{{Fill Schedule Description}}

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

{{Fill ScheduleEvent Description}}

Type:ScheduleEventType
Parameter Sets:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendWakeupPacket

{{Fill SendWakeupPacket Description}}

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

{{Fill SlowNetworkOption Description}}

Type:SlowNetworkOptionType
Parameter Sets:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareInstallation

{{Fill SoftwareInstallation Description}}

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

{{Fill SystemRestart Description}}

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

{{Fill UseMeteredNetwork Description}}

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

{{Fill UseUtc Description}}

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

{{Fill UseUtcForAvailableSchedule Description}}

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

{{Fill UseUtcForExpireSchedule Description}}

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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

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

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object