Compartilhar via


Using WMI to Configure New Users

Tópico modificado em: 2009-05-22

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 Atributos e descrições dos Serviços de Domínio Active Directory in the Preparing Active Directory Domain Services for Office Communications Server 2007 R2 documentation.

Active Directory Attributes to WMI Properties Mapping

Dica

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.