New-CMPackageDeployment

Creates a package deployment

Syntax

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

Examples

Example 1

PS C:\>

Required Parameters

-DeviceProgram
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Package
Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-PackageId
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PackageName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Program
Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ProgramName
Type:String
Aliases:StandardProgramName, DeviceProgramName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-StandardProgram
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AllowSharedContent
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AvailableDateTime
Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Collection
Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionId
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CollectionName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Comment
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
Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeployPurpose
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
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributeContent
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointGroupName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DistributionPointName
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FastNetworkOption
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
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecurUnit
Type:RecurUnitType
Parameter Sets:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RecurValue
Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Rerun
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RerunBehavior
Type:RerunBehaviorType
Parameter Sets:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RunFromSoftwareCenter
Type:Boolean
Aliases:AllowUsersRunIndependently
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Schedule
Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScheduleEvent
Type:ScheduleEventType
Parameter Sets:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SendWakeupPacket
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SlowNetworkOption
Type:SlowNetworkOptionType
Parameter Sets:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SoftwareInstallation
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SystemRestart
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseMeteredNetwork
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseUtc
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseUtcForAvailableSchedule
Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseUtcForExpireSchedule
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