Syntax

Parameters

Syntax

Parameters

Remarks

• The XML file from which you want to import assignment information must follow the structure described below.
  • UserList element

    The UserList is the top element of the XML file.

  • User element

    Each User element contains information about a user who is a member of a domain. Each user might be assigned one or more line devices.

    Additionally, each User element might have an attribute named NoMerge. When this attribute is specified, all current line device assignments for the user are removed before new ones are made. You can use this attribute to easily remove unwanted user assignments. By default, this attribute is not set.

    The User element must contain a single DomainUserName element, which specifies the domain and user name of the user. The User element might also contain one FriendlyName element, which specifies a friendly name for the user.

    The User element might contain one LineList element. If a LineList element is not present, all line devices for this user are removed.

  • LineList element

    The LineList element contains information about each line or device that might be assigned to the user. Each LineList element can contain more than one Line element.

  • Line element

    Each Line element specifies a line device. You must identify each line device by adding either an Address element or a PermanentID element under the Line element.

    For each Line element, you can set the Remove attribute. If you set this attribute, the user is no longer assigned that line device. If this attribute is not set, the user gains access to that line device. No error is given if the line device is not available to the user.

• The following sample XML code segments illustrate correct usage of the elements defined above
  • The following code removes all line devices assigned to User1.

    <UserList>
      <User NoMerge="1">
        <DomainUser>domain1\user1 </DomainUser>
      </User>
    </UserList>

  • The following code removes all line devices assigned to User1 before assigning one line with address 99999. User1 will have no other lines devices assigned, regardless of whether any line devices were assigned previously.

    <UserList>
      <User NoMerge="1">
        <DomainUser>domain1\user1</DomainUser>
        <FriendlyName>User1</FriendlyName>
        <LineList>
          <Line>
            <Address>99999</Address>
          </Line>
        </LineList>
      </User>
    </UserList>
    

  • The following code adds one line device for User1 without deleting any previously assigned line devices.

    <UserList>
      <User>
        <DomainUser>domain1\user1</DomainUser>
        <FriendlyName>User1</FriendlyName>
        <LineList>
          <Line>
            <Address>99999</Address>
          </Line>
        </LineList>
      </User>
    </UserList>

  • The following code adds line address 99999 and removes line address 88888 from User1's access.

    <UserList>
      <User>
        <DomainUser>domain1\user1</DomainUser>
        <FriendlyName>User1</FriendlyName>
        <LineList>
          <Line>
            <Address>99999</Address>
          </Line>
          <Line Remove="1">
            <Address>88888</Address>
          </Line>
        </LineList>
      </User>
    </UserList>

  • The following code adds permanent device 1000 and removes line 88888 from User1's access.

  • <UserList>
      <User>
        <DomainUser>domain1\user1</DomainUser>
        <FriendlyName>User1</FriendlyName>
        <LineList>
          <Line>
            <PermanentID>1000</PermanentID>
          </Line>
          <Line Remove="1">
            <Address>88888</Address>
          </Line>
        </LineList>
      </User>
    </UserList>
    

• The following sample output appears after the -d command-line option is specified to display the current TAPI configuration. For each telephony provider, the associated line devices are listed, as well as the addresses and users associated with each line device.

  NDIS Proxy TAPI Service Provider
          Line: "WAN Miniport (L2TP)"
                  Permanent ID: 12345678910
  
  NDIS Proxy TAPI Service Provider
          Line: "LPT1DOMAIN1\User1"
                  Permanent ID: 12345678910
  
  Microsoft H.323 Telephony Service Provider
          Line: "H323 Line"
                  Permanent ID: 123456
                  Addresses:
                          BLDG1-TAPI32
  

Formatting legend