Qualifiers Specific to the SNMP Provider

Qualifiers contain implementation-specific context information and transport properties that define how the SNMP Provider accesses an SNMP agent. The following lists the qualifiers unique to the SNMP Provider.

AgentAddress

Data type: CIM_STRING

Transport address associated with the SNMP agent, such as an IP address or DNS name. You should set AgentAddress to a valid unicast host address or a domain host name that can be resolved through the operating system's domain-name resolution process. AgentAddress has no default value.

AgentFlowControlWindowSize

Data type: CIM_SINT32

Maximum number of concurrently outstanding SNMP requests that can be sent to this agent while a response has not yet been received. An SNMP request is considered outstanding until a PDU response has been received or it has timed out. A large window size generally improves performance, but some agents might not work well under a heavy load. AgentFlowControlWindowSize can be set to 0 to indicate an infinite window size or to an integer between 1 and 2^32-1. The default value is 10. This qualifier is optional.

AgentReadCommunityName

Data type: CIM_STRING

Variable-length octet string that is used by the SNMP agent to authenticate an SNMP Protocol Data Unit (PDU) during a read operation (SNMP GET/GET NEXT requests). The community name must be mapped to a Unicode string and is limited to alphanumeric characters. The default value is public. This qualifier is optional.

AgentRetryCount

Data type: CIM_SINT32

Number of times a single SNMP request can be retried when there is no response from the SNMP agent before the request is deemed to have failed. AgentRetryCount must be set to an integer between 0 and 2^32-1. The default value is 1. This qualifier is optional.

AgentRetryTimeout

Data type: CIM_SINT32

Time in milliseconds before the SNMP Protocol Data Unit (PDU) is considered to have been dropped. This is the number of milliseconds to wait for a response to an SNMP request sent to the SNMP agent. AgentRetryTimeout must be set to an integer between 0 and 2^32-1. The default value is 500. This qualifier is optional.

AgentSNMPVersion

Data type: CIM_STRING

Version of the SNMP protocol to be used when communicating with the SNMP agent. Currently, the only valid values are 1 (for SNMPv1) and 2C (for SNMPv2C). The default value is 1. This qualifier is optional.

AgentTransport

Data type: CIM_STRING

Transport protocol used to communicate with the SNMP agent. Currently the only valid values are Internet Protocol (IP) and Internet Packet Exchange (IPX). The default value is IP. This qualifier is optional.

AgentVarBindsPerPdu

Data type: CIM_SINT32

Maximum number of variable bindings contained within a single SNMP PDU. Every SNMP request sent to the SNMP agent contains one or more SNMP variables. This parameter specifies the largest number of variables that can be included in a single request. AgentVarBindsPerPdu can be set to 0 (zero) to cause the implementation to determine the optimal variable bindings or to an integer between 1 and 2^32-1. Note that while increasing this value can improve performance, some agents and networks cannot deal with the resulting request. The default value is 10. This qualifier is optional.

AgentWriteCommunityName

Data type: CIM_STRING

Variable-length octet string that is used by the SNMP agent to authenticate an SNMP Protocol Data Unit (PDU) during a write operation (SNMP SET request). The community name must be mapped to a Unicode string and is limited to alphanumeric characters. The default value is public. This qualifier is optional.

Requirements

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008