Using the TSecImp Command-Line Tool

  • Article

Applies To: Windows Server 2008 R2

TSecImp imports line and phone assignment information from an XML file into the telephony server security file (Tsec.ini). You can also use this command to display the list of telephony service providers and the lines and devices associated with each of them, validate the structure of the XML file without importing the contents, and check domain membership of the users for which you want to add permissions.

To import an XML file into the Tsec.ini file

Syntax

tsecimp -fFileName [{-v | -u}]

Parameters
  • -fFileName**
    Required. Specifies the name of the XML file that contains the assignment information that you want to import.
  • -v
    Validates the structure of the XML file without importing the information into the Tsec.ini file.
  • -u
    Checks whether each user is a member of the domain specified in the XML file. The computer on which you use this parameter must be connected to the network. This parameter might significantly slow performance if you are processing a large amount of user assignment information.

To display telephony service providers with their lines and devices

Syntax

tsecimp -d

Parameters
  • -d
    Displays a list of installed telephony providers. For each telephony provider, the associated line devices are listed, as well as the IP addresses and users associated with each line device.

XML file structure

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. If a LineList element is not present, all line devices for this user are removed.

  • 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 reported to you if the line device is not available to the user.

Sample XML file syntax

  • The following sample XML code segments illustrate correct usage of the elements defined above.

    • The following code removes all line devices assigned to User1 by using the NoMerge attribute.

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

    • The following code removes all line devices assigned to User1 by using the NoMerge attribute, before assigning one line with address 99999 by including a LineList with one Line element. 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 access by User1.

      <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 access by User1.

      <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 telephony server 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

Format Meaning

Italic

Information that the user must supply

Bold

Elements that the user must type exactly as shown

Between brackets ([])

Optional items

Between braces ({}); choices separated by pipe (|). Example: {even|odd}

Set of choices from which the user must choose only one

Courier font

Code or program output

Additional references