The SMS_SoftwareDistributionAgentConfig Windows Management Instrumentation (WMI) class is an SMS Provider server class, in Configuration Manager, that specifies how client computers deploy software.
The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties.
Class SMS_SoftwareDistributionAgentConfig : SMS_ClientAgentConfig_BaseClass { UInt32 AgentID; UInt32 CacheContentTimeout; UInt32 CacheSpaceFailureRetryCount; UInt32 CacheSpaceFailureRetryInterval; UInt32 CacheTombstoneContentMinDuration; UInt32 ContentLocationTimeoutInterval; UInt32 ContentLocationTimeoutRetryCount; UInt32 DefaultMaxDuration; Boolean DisplayNewProgramNotification; UInt32 DownloadModificationInterval; UInt32 DownloadRetryInterval; UInt32 ExecutionFailureRetryCount; UInt32 ExecutionFailureRetryErrorCodes[]; UInt32 ExecutionFailureRetryInterval; Boolean LockSettings; UInt32 LogoffReturnCodes[]; UInt32 NetworkFailureRetryCount; UInt32 NetworkFailureRetryInterval; String NewProgramNotificationUI; Boolean RebootLogoffNotification; UInt32 RebootReturnCodes[]; Boolean RunNotification; UInt32 RunNotificationCountdownDuration; UInt32 SuccessReturnCodes[]; UInt32 UIContentLocationTimeoutInterval; UInt32 UserPreemptionCountdown; UInt32 UserPreemptionTimeout; UInt32 WhatsNewDuration; }; |
Methods
The SMS_SoftwareDistributionAgentConfig class does not define any methods.
Properties
- AgentID
- Data type: UInt32Access type: Read-only Qualifiers: [key, read]Identifies the client agent component. The Software Distribution Agent ID is 6.
- CacheContentTimeout
- Data type: UInt32Access type: Read/Write Qualifiers: noneDuration, in seconds, after which content can be deleted from the cache, even when referenced.
- CacheSpaceFailureRetryCount
- Data type: UInt32Access type: Read/Write Qualifiers: noneNumber of times to retry for non-fatal cache errors (-1 = 4,294,967,295 retries).
- CacheSpaceFailureRetryInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneInterval, in seconds, between retry attempts for non-fatal cache errors.
- CacheTombstoneContentMinDuration
- Data type: UInt32Access type: Read/Write Qualifiers: noneMinimum duration, in seconds, that content must be kept in the cache. This value does not set any extra time for the content to be kept in the cache after being tombstoned.
- ContentLocationTimeoutInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneDuration, in seconds, after which attempts to locate content should be failed.
- ContentLocationTimeoutRetryCount
- Data type: UInt32Access type: Read/Write Qualifiers: noneNumber of times a content location request retries after recoverable failures have occurred.
- DefaultMaxDuration
- Data type: UInt32Access type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- DisplayNewProgramNotification
- Data type: BooleanAccess type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- DownloadModificationInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- DownloadRetryInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- ExecutionFailureRetryCount
- Data type: UInt32Access type: Read/Write Qualifiers: noneNumber of times to retry for non-fatal execution errors (-1 = 4,294,967,295 retries).
- ExecutionFailureRetryErrorCodes
- Data type: UInt32 Array Access type: Read/Write
Qualifiers: noneA list of the default program retry values from the
site. If a program fails with one of these exit codes, the program
will be retried. The possible values are:
- ExecutionFailureRetryInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneInterval, in seconds, between retry attempts for non-fatal execution errors.
- LockSettings
- Data type: BooleanAccess type: Read/Write Qualifiers: nonetrue if the site settings are locked and cannot be overridden.
- LogoffReturnCodes
- Data type: UInt32 Array Access type: Read/Write Qualifiers: noneArray of program return codes that indicate a logoff is required.
- NetworkFailureRetryCount
- Data type: UInt32Access type: Read/Write Qualifiers: noneNumber of times to retry for non-fatal network errors (-1 = 4,294,967,295 retries).
- NetworkFailureRetryInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneInterval, in seconds, between retry attempts for non-fatal network errors.
- NewProgramNotificationUI
- Data type: StringAccess type: Read/Write Qualifiers:
[valuemap]The console that should be shown when a user
double-clicks a new program notification. Possible values are:
ARP
Add/Remove Programs
RAP
Run Advertised Programs
- RebootLogoffNotification
- Data type: BooleanAccess type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- RebootReturnCodes
- Data type: UInt32 Array Access type: Read/Write Qualifiers: noneArray of program return codes that indicate a restart is required.
- RunNotification
- Data type: BooleanAccess type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- RunNotificationCountdownDuration
- Data type: UInt32Access type: Read/Write Qualifiers: noneThis property is no longer used by the client.
- SuccessReturnCodes
- Data type: UInt32 Array Access type: Read/Write Qualifiers: noneArray of program return codes that indicate success.
- UIContentLocationTimeoutInterval
- Data type: UInt32Access type: Read/Write Qualifiers: noneDuration, in seconds, after which attempts to locate content should be failed.
- UserPreemptionCountdown
- Data type: UInt32Access type: Read/Write Qualifiers: noneDuration, in seconds, of the countdown displayed to the user before preemption.
- UserPreemptionTimeout
- Data type: UInt32Access type: Read/Write Qualifiers: noneThe duration, in seconds, after which a pending mandatory program will run, if the user does not click Run on the Ready to Run dialog for their optional program. This timeout is used so that mandatory programs are not blocked forever by users not clicking Run on the Download Completed/Ready to Run dialog for optional requests.
- WhatsNewDuration
- Data type: UInt32Access type: Read/Write Qualifiers: noneThis property is no longer used by the client.
Remarks
Requirements
Runtime Requirements
For more information, see Configuration Manager Server Runtime Requirements.
Development Requirements
For more information, see Configuration Manager Server Development Requirements.