Office Communications Server Provider::SetSipUserProperties

This procedure sets SIP user properties on an Active Directory user account enabled for Office Communications Server.

Input argument	Required	Type	Description
<preferredDomainController>	Yes	string	The domain controller to use for Active Directory actions.
<allowOrganizeMeetingWithAnonymousParticipants>	No	boolean	This parameter controls whether to allow the user to invite anonymous users to meetings. If true the user is allowed to invite anonymous users. If false the user is not allowed to invite anonymous users. The default is false.
<archiveFederatedCommunications>	No	boolean	This setting controls whether to archive the user's communications across federated domains.
<archiveInternalCommunications>	No	boolean	This setting controls whether to archive the user's communications within their internal domain.
<enabled>	No	boolean	This parameter determines whether to enable the user for Office Communications Server. If true, the user is enabled for Office Communications Server. If false, the user does not have specific support under SIP.
<enabledForEnhancedPresence>	No	boolean	This parameter controls whether to enable the user for enhanced presence. If true, the user is enabled for enhanced presence. If false, the user is not enabled for enhanced presence. The default is false.
<enabledForFederation>	No	boolean	This parameter controls whether to enable the user for federation. If true, the user is enabled for federation. If false, the user is not enabled for federation. The default is false.
<enabledForInternetAccess>	No	boolean	This parameter controls whether to enable the user for Internet access. If true, the user is enabled for Internet access. If false, the user is not enabled for Internet access. The default is false.
<homeServerDN>	No	string	This parameter specifies the distinguished name of the Pool Service (msRTCSIP-PoolService) where the Office Communications Server user is hosted.
<ipPBXSoftPhoneRoutingEnabled>	No	boolean	If true, the user is enabled for both remote call control and Enterprise Voice. This requires that UCEnabled be set to true.
<lineServerURI>	No	string	The SIP URI of the telephony gateway server assigned to this user for remote-call control (RCC). A valid SIP URI uses the following form: Sip:abc@pbx1.phones.microsoft.com. This property is not indexed, but is marked for global container replication. If RemoteCallControlTelephoneyEnabled is true, this value cannot be NULL. The value of this property is not case-sensitive. The maximum length of the string is 454 characters.
<lineURI>	No	string	Either the SIP URI or the Tel. URI of the user's phone line. This value is used by the Microsoft Office Communicator client and by Enterprise Voice for call routing. A valid SIP URI uses the following form: sip:+14257777777@phones.fabrikam.com;user=phone.This SIP URI value must be unique. A valid Tel. URI uses the following form: tel:+14257071111;ext=71111;attribute=telephone number This property is indexed and marked for global container replication. If RemoteCallControlTelephoneyEnabled is true, this value cannot be NULL. The value of this property is not case-sensitive. The maximum length of the string is 454 characters.
<meetingPolicy>	No	string	This parameter specifies the name of the meeting policy to be applied to the user.
<primaryURI>	No	string	The primary SIP URI of the user. This URI must be unique and must be represented in the form "sip:user@domain" where the domain substring is either a fully qualified domain name or a valid IP address. The maximum length of the string is 454 characters.
<publicNetworkEnabled>	No	boolean	This parameter controls whether the user is able to exchange instant messages with other users who are hosted by one or more public Instant Messaging (IM) service providers. If true, the user is authorized for public IM connectivity. If false, the user is not authorized for public IM connectivity. The default is false.
<remoteCallControlTelephonyEnabled>	No	boolean	This parameter controls whether the user is able to use the Microsoft Office Communicator client in combination with the user's computer to initiate, receive, and forward phone calls. If true, the user is authorized for remote call control. If false, the user is not authorized for remote call control. If the value is true, LineURI and LineServerURI cannot be null. The default value is false.
<ucEnabled>	No	boolean	This parameter determines whether to enable the user for Unified Communications. If true, the user is enabled for Unified Communications. If false, the user is not enabled for Unified Communications. The default is false.
<ucPolicy>	No	string	This parameter specifies the distinguished name of the Unified Communications policy assigned for this user. This parameter is required if the user is enabled for Unified Communications.
<userDN>	Yes	string	This parameter specifies the distinguished name of the Active Directory object that is associated with the Office Communications Server user.

Remarks

Sample Code

Example XML Request

<request>
  <data>
	<preferredDomainController>ad01.fabrikam.com</preferredDomainController>
	<userDN>CN=JohnC@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</userDN>
	<homeServerDN>CN=LC Services,CN=Microsoft,CN=pool,CN=Pools,CN=RTC Service,CN=Microsoft,CN=System,DC=fabrikam,DC=com</homeServerDN>
	<primaryURI>sip:JohnC@fabrikam.com</primaryURI>
	<enabled>true</enabled>
	<enabledForEnhancedPresence>true</enabledForEnhancedPresence>
	<enabledForFederation>false</enabledForFederation>
	<enabledForInternetAccess>true</enabledForInternetAccess>
	<publicNetworkEnabled>false</publicNetworkEnabled>
  </data>
  <procedure>
	<execute namespace="Office Communications Server Provider" procedure="SetSipUserProperties" impersonate="2">
	<before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" />
	<before source="data" sourcePath="userDN" destination="executeData" mode="move" />
	<before source="data" sourcePath="homeServerDN" destination="executeData" mode="move" />
	<before source="data" sourcePath="primaryURI" destination="executeData" mode="move" />
	<before source="data" sourcePath="enabled" destination="executeData" mode="move" />
	<before source="data" sourcePath="enabledForEnhancedPresence" destination="executeData" mode="move" />
	<before source="data" sourcePath="enabledForFederation" destination="executeData" mode="move" />
	<before source="data" sourcePath="enabledForInternetAccess" destination="executeData" mode="move" />
	<before source="data" sourcePath="publicNetworkEnabled" destination="executeData" mode="move" />
	<after source="executeData" destination="data" mode="merge" />
	</execute>
  </procedure>
</request>

Applies To