Using WMI to Configure New Users
Your organization might choose to create your own scripts to enable new users for Office Communications Server instead of using the Active Directory Users and Computers snap-in or the Office Communications Server administrative snap-in. This section identifies the Active Directory attributes that can be set for new users and maps them to their associated WMI properties.
Working with Active Directory Attributes
Keep the following points in mind when setting Active Directory attributes to enable new users:
- Active Directory attributes that are not defined map to either FALSE (if Boolean) or NULL in WMI.
- Some attributes have a bit-mask value. For these attributes, each setting is represented by a bit, and the displayed decimal value represents the bit placement. Each bit represents a WMI property. The following are some examples:
- 10000 (binary) has a decimal value of 16 (bit 4 is set)
- 100000000 (binary) has a decimal value of 256 (bit 8 is set)
- 1100 (binary) has a decimal value of 12 (bits 2 and 3 are set; WMI properties represented by both bits are enabled)
- 1111000001 (binary) has a decimal value of 961 (bits 0, 6, 7, 8, and 9 are set; WMI properties for each of these bits are enabled)
For more information about Active Directory attributes, see Active Directory ドメイン サービスの属性と説明 in the Preparing Active Directory Domain Services for Office Communications Server 2007 R2 documentation.
Active Directory Attributes to WMI Properties Mapping
注意
Attributes in bold are required for enabling users for Office Communications Server.
Active Directory Attributes for New Users
| Active Directory Attribute | WMI Property | Comments |
|---|---|---|
msRTCSIP-ArchivingEnabled |
Identifies whether user’s communications are archived. Each WMI property is represented by a set bit. Values are: |
|
Bit 2 set |
ArchiveInternalCommunications |
4 decimal (100 binary) |
Bit 3 set |
ArchiveFederatedCommunications |
8 decimal (1000 binary) |
msRTCSIP-FederationEnabled |
EnabledForFederation |
True/False |
msRTCSIP-InternetAccessEnabled |
EnabledForInternetAccess |
True/False |
msRTCSIP-Line |
LineURI |
The device ID (SIP URI or TEL URI) of the phone the user controls. For example: tel:+142489982. If a user is enabled for Enterprise voice, the E.164 normalized version of the user’s phone number. |
msRTCSIP-LineServer |
LineServerURI |
SIP URI of the CSTA-SIP gateway server. For example: sip:pbx@vdomain.com |
msRTCSIP-OptionFlags |
Each option is represented by a set bit. Values are: |
|
Bit 0 set |
PublicNetworkEnabled |
1 decimal (1 binary) |
Bit 4 set |
RemoteCallControlTelephonyEnabled |
16 decimal (10000 binary) |
Bit 6 set |
AllowOrganizeMeetingWithAnonymousParticipants |
64 decimal (1000000 binary) |
Bit 7 set |
UCEnabled |
128 decimal (10000000 binary) |
Bit 8 set |
EnabledForEnhancedPresence |
256 decimal (100000000 binary) |
Bit 9 set |
IPPBXSoftPhoneRoutingEnabled |
512 decimal (1000000000 binary) |
msRTCSIP-PrimaryHomeServer |
HomeServerDN |
The DN of the pool where user is homed |
msRTCSIP-PrimaryUserAddress |
PrimaryURI |
SIP address of the user |
msRTCSIP-UserEnabled |
Enabled |
True/False |
msRTCSIP-UserLocationProfile |
LocationProfile |
The DN of a location profile object |
msRTCSIP-UserPolicy |
A multi-valued attribute (array) containing a list of DNs of global user policies for the three types of policies. The policy DN is appended to the binary value to indicate the type of policy to which the DN points. |
|
B:8:01000000 |
MeetingPolicy |
B:8:01000000:<DN of meeting policy> |
B:8:02000000 |
UCPolicy |
B:8:02000000:<DN of UC policy> |
B:8:05000000 |
PresencePolicy |
B:8:05000000:<DN of presence policy> |
proxyAddresses |
- |
When a user is enabled, the user’s SIP address should be added to this multi-value attribute. When a user is updated, the SIP address should be updated, and when a user is deleted for Office Communications Server (not deleted in AD DS), the SIP address should be removed. |