5/13/2011

This method distributes the configuration package to the target collection.

Syntax

public static void Deploy(
  string 
provpackageUniqueId, 
  string 
collectionID, 
  string 
name, 
  string 
comments, 
  bool 
includesubcoll, 
  DateTime 
PresentTime, 
  bool 
PresentTimeIsGMT, 
  DateTime 
ExpirationTime, 
  bool 
ExpirationTimeEnabled, 
  bool 
ExpirationTimeIsGMT, 
  UInt32 
AdvertFlags, 
  UInt32 
RemoteClientFlags, 
  string 
AssignedSchedule, 
  UInt32 Priority
);

Parameters

provpackageUniqueId

[in] Identifier for the configuration package to be distributed.

collectionID

[in] Identifier of the collection to which this package is distributed.

name

[in] Name of the advertisement.

comments

[in] Optional. Comments about the advertisement.

includesubcoll

[in] Trueif the configuration package is distributed to subcollections. Falseif the configuration package is not distributed to subcollections.

PresentTime

[in] Date and time that this method is called.

PresentTimeIsGMT

[in] Trueif PresentTimeis in Coordinated Universal Time (Greenwich Mean Time); Falseotherwise.

ExpirationTime

[in] Date and time that the configuration package expires.

ExpirationTimeEnabled

[in] Trueif there is an expiration time set for the configuration package in ExpirationTime. Falseif the package does not expire.

ExpirationTimeIsGMT

[in] Trueif ExpirationTimeis in Coordinated Universal Time (Greenwich Mean Time); Falseotherwise.

AdvertFlags

[in] Flag indicating how the advertisement should be announced to the user. Initially no flag is set. Select flags from the following table.

Hex (Bit) value

Description

0x00000020 (5)

IMMEDIATE. Announce the advertisement to the user immediately.

0x00000100 (8)

ONSYSTEMSTARTUP. Announce the advertisement to the user on system startup.

0x00000200 (9)

ONUSERLOGON. Announce the advertisement to the user on logon.

0x00000400 (10)

ONUSERLOGOFF. Announce the advertisement to the user on logoff.

0x00008000 (15)

WINDOWS_CE. The advertisement is for a device.

0x00020000 (17)

DONOT_FALLBACK. Do not fall back to unprotected distribution points.

0x00040000 (18)

ENABLE_TS_FROM_CD_AND_PXE. The task sequence is available to removable media and the Pre-Boot eXecution Environment (PXE) service point.

0x00100000 (20)

OVERRIDE_SERVICE_WINDOWS. Override maintenance windows in announcing the advertisement to the user.

0x00200000 (21)

REBOOT_OUTSIDE_OF_SERVICE_WINDOWS. Reboot outside of maintenance windows.

0x00400000 (22)

WAKE_ON_LAN_ENABLED. Announce the advertisement to the user with Wake On LAN enabled.

0x00800000 (23)

SHOW_PROGRESS. Announce the advertisement to the user showing task sequence progress.

0x02000000 (25)

NO_DISPLAY. The user should not run programs independently of the assignment.

0x04000000 (26)

ONSLOWNET. Assignments are mandatory over a slow network connection.

RemoteClientFlags

[in] Flags specifying how the program should run when the device is connected either locally or remotely to a distribution point. Initially no flag is set. Select flags from the following table.

Hex (Bit) value

Description

0x00000001 (0)

BATTERY_POWER. Run the program by using battery power. This value is currently unused.

0x00000002 (1)

RUN_FROM_CD. Run the program from CD. This value is currently unused.

0x00000004 (2)

DOWNLOAD_FROM_CD. Download the program from CD. This value is currently unused.

0x00000008 (3)

RUN_FROM_LOCAL_DISPPOINT. Run the program from the local distribution point.

0x00000010 (4)

DOWNLOAD_FROM_LOCAL_DISPPOINT. Download the program from the local distribution point.

0x00000020 (5)

DONT_RUN_NO_LOCAL_DISPPOINT. Do not run the program if there is no local distribution point.

0x00000040 (6)

DOWNLOAD_FROM_REMOTE_DISPPOINT. Download the program from the remote distribution point.

0x00000080 (7)

RUN_FROM_REMOTE_DISPPOINT. Run the program from the remote distribution point.

0x00000100 (8)

DOWNLOAD_ON_DEMAND_FROM_LOCAL_DP. Download the program on demand from the local distribution point. This is only applicable for task sequences.

0x00000200 (9)

DOWNLOAD_ON_DEMAND_FROM_REMOTE_DP. Download the program on demand from the remote distribution point. This is only applicable for task sequences.

0x00000400 (10)

BALLOON_REMINDERS_REQUIRED. Balloon reminders are required.

0x00000800 (11)

RERUN_ALWAYS. Always rerun the program.

0x00001000 (12)

RERUN_NEVER. Never rerun the program.

0x00002000 (13)

RERUN_IF_FAILED. Rerun the program if execution previously failed.

0x00004000 (14)

RERUN_IF_SUCCEEDED. Rerun the program if execution previously succeeded.

AssignedSchedule

[in] Instance of the SMS_ScheduleTokenclass that specifies the time when the advertisement must start on the devices.

Priority

[in] Priority used in replicating the advertisement to secondary site servers. The default value is NORMAL ( 2). Possible values are:

Value

Description

1

HIGH

2

NORMAL

3

LOW

Return Value

None

Remarks

None

See Also