TSecImp 會將 XML 檔案中的線路與電話指派資訊匯入到電話語音伺服器安全性檔案 (Tsec.ini)。您也可以使用此命令來顯示電話語音服務提供者清單以及每個提供者的線路與裝置,驗證 XML 檔的結構而不用匯入其內容,以及檢查需要新增權限之使用者的網域成員資格。

匯入 XML 檔到 Tsec.ini 檔

語法

tsecimp -f FileName [{-v | -u}]

參數
-f FileName
必要。指定需匯入其指派資訊的 XML 檔案名稱。

-v
驗證 XML 檔案結構,而不要將資訊匯入 Tsec.ini 檔案。

-u
檢查每位使用者是否是 XML 檔案中指定的網域成員。使用此參數的電腦必須連線到網路。如果您正在處理大量的使用者指派資訊,此參數可能會大幅降低效能。

顯示電話語音服務提供者及其線路與裝置

語法

tsecimp -d

參數
-d
顯示已安裝的電話語音提供者清單。也會針對每個電話語音提供者,列出相關聯的線路裝置,還會列出與每個線路裝置相關聯的 IP 位址和使用者。

XML 檔案結構

要匯入指派資訊的 XML 檔案必須遵循下述結構。

  • UserList 項目

    UserList 是 XML 檔案的最上層項目。

  • User 項目

    每個 User 項目包含屬於網域成員的使用者資訊。每位使用者可以被指派一或多個線路裝置。

    此外,每個 User 項目可能會有名稱為 NoMerge 的屬性。當指定此屬性時,會先移除使用者的所有目前線路裝置指派,然後才建立新的指派。使用此屬性可以輕鬆地移除不想要的使用者指派。依預設,不會設定此選項。

    User 項目必須包含單一 DomainUserName 項目,此項目會指定使用者的網域與使用者名稱。User 項目也可以包含一個 FriendlyName 項目,該項目可為使用者指定一個好記的名稱。

    User 項目可以包含一個 LineList 項目。如果沒有 LineList 項目,會移除此使用者的所有線路裝置。

  • LineList 項目

    LineList 項目包含指派給使用者的每個線路或裝置的資訊。每個 LineList 項目可以包含一個以上的 Line 項目。如果沒有 LineList 項目,會移除此使用者的所有線路裝置。

  • Line 項目

    每個 Line 項目會指定一個線路裝置。您必須在 Line 項目下新增 Address 項目或 PermanentID 項目來識別每個線路裝置。

    對於每個 Line 項目,可以設定 Remove 屬性。如果設定此屬性,就無法再指派該線路裝置給使用者。如果未設定此屬性,使用者會取得該線路裝置的存取權。假使線路裝置不提供給使用者,並不會對您報告錯誤。

範例 XML 檔案語法

  • 下列範例 XML 程式碼區段說明上述定義項目的正確用法。

    • 下列程式碼將使用 NoMerge 屬性移除指派給 User1 的所有線路裝置。

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
        </User>
      </UserList>
    • 下列程式碼將使用 NoMerge 屬性移除指派給 User1 的所有線路裝置,然後才包含 LineList 與一個 Line 項目指派一個位址為 99999 的線路。無論之前是否指派任何線路裝置給 User1,之後將不會被指派其他線路裝置。

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • 下列程式碼會為 User1 新增一個線路裝置,而不用刪除任何之前指派的線路裝置。

      <UserList>
        <User>
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • 下列程式碼會新增線路位置 99999 並移除 User1 可以存取的線路位址 88888。

      <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>
    • 下列程式碼會新增永久裝置 1000 並移除 User1 可以存取的線路位址 88888。

      <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>
  • 指定 -d 命令列選項來顯示目前的電話語音伺服器設定後,會出現下列範例輸出結果。對於每個電話語音提供者,會列出相關聯的線路裝置,也會列出與每個線路裝置相關聯的位址和使用者。

    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

格式圖例

格式 意義

斜體

使用者必須提供的資訊

粗體

使用者必須依照顯示的方式輸入的元素

以方括弧括住 ([])

選擇性項目

以括弧括住 ({});而且選項中間以垂直線 (|) 分隔。範例:{even|odd}

使用者必須從中選擇一項的選項集

Courier font

程式碼或程式輸出

其他參考資料


目錄