MSFT_SIPGlobalPresenceSetting (New)

Article
05/23/2014

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Specifies the globally enforced presence policy. A presence policy is a set of presence limits and restrictions that are applied to user or contact objects. The global presence policy is applied to all users when UsePerUserPresencePolicy is set to False. The global presence policy is configured on a forest-wide basis.

MSFT_SIPGlobalPresenceSetting

The MSFT_SIPGlobalPresenceSetting properties do not map to the Administration Tool.

The following syntax is simplified from Managed Object Format (MOF) code and includes all inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

class MSFT_SIPGlobalPresenceSetting
{
  [key] string InstanceID;
  string PresencePolicy;
  boolean UsePerUserPresencePolicy;
};

Methods

This class does not define any methods.

Properties

The MSFT_SIPGlobalPresenceSetting class has the following properties.

InstanceID
Data type: [key] string

Access type: Read-only

Required. A GUID value that uniquely identifies an instance of this class.

The GUID must be encapsulated between the "{" and "}" braces; for example: "{01234567-0123-4567-89AB-CDEF01234567}".
PresencePolicy
Data type: string

Access type: Read/Write

Required. Specifies the distinguished name of the global presence policy.

The policy specified by this property is enforced for all users when the UsePerUserPresencePolicy property is set to False. The default presence policy for a deployment is then applied to all users if this policy is deleted.

The value of this property is not case-sensitive.
UsePerUserPresencePolicy
Data type: boolean

Access type: Read/Write

Required. Specifies whether to apply presence policies individually to users or groups of users instead of applying the global policy to all users.

When this property value is True, presence policies may be assigned to individual users or groups of users. The default policy is applied to any user not assigned a presence policy or when an assigned policy is deleted.

Remarks

This class gets and sets information at the following levels: Active Directory.

Only one instance of this class can be present in the forest.

Instances of this class support the following interface methods:

Provider::EnumerateInstances();
Provider::GetObject();
Provider::PutInstance();

Where PutInstance() supports the following flag:
- WBEM_FLAG_UPDATE_ONLY

Scripting

You can use code similar to the following to bind to the MSFT_SIPGlobalPresenceSetting class. In the two examples, the dot (.) represents the local computer. To bind to a remote computer, replace the dot with the name of that computer (e.g., atl-ocs-001).

VBScript

strComputer = "."
wmiQuery = "Select * From MSFT_SIPGlobalPresenceSetting"
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\cimv2")
Set colItems = objWMIService.ExecQuery(wmiQuery)

Windows Powershell

$colItems = Get-WMIObject MSFT_SIPGlobalPolicySetting –computer "."

Requirements

Server: Installed on computers serving the following roles: Administrative Tools Server, Audio/Video Conferencing Server, Front End Server, Proxy Server, and Web Components Server.

Namespace: Defined in \root\cimv2.