TSecImp importa le informazioni sulle assegnazioni di linee e telefoni da un file XML al file di sicurezza del server di telefonia (Tsec.ini). Tale comando consente inoltre di visualizzare l'elenco dei provider di servizi di telefonia e le linee e le periferiche associate a ognuno di essi, convalidare la struttura del file XML senza importarne il contenuto e verificare che gli utenti per i quali si desidera aggiungere le autorizzazioni appartengano effettivamente al dominio.

Per importare un file XML nel file Tsec.ini

Sintassi

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

Parametri
-f NomeFile
Obbligatorio. Specifica il nome del file XML che contiene le informazioni sulle assegnazioni da importare.

-v
Convalida la struttura del file XML senza importare le informazioni nel file Tsec.ini.

-u
Verifica l'appartenenza di ogni utente al dominio specificato nel file XML. È necessario che il computer sul quale si utilizza questo parametro sia connesso alla rete. Questo parametro può rallentare le prestazioni in modo significativo se si elabora una grande quantità di informazioni sulle assegnazioni degli utenti.

Per visualizzare i provider di servizi di telefonia insieme alle rispettive linee e periferiche

Sintassi

tsecimp -d

Parametri
-d
Visualizza un elenco dei provider di telefonia installati. Per ogni provider di telefonia sono elencate le periferiche di linea associate, oltre agli indirizzi IP e agli utenti associati a ogni periferica di linea.

Struttura del file XML

Il file XML dal quale vengono importate le informazioni sulle assegnazioni deve seguire la struttura descritta di seguito.

  • Elemento UserList

    UserList è il primo elemento del file XML.

  • Elemento User

    Ogni elemento User contiene informazioni su un utente che è membro di un dominio. A ogni utente devono essere assegnate una o più periferiche di linea.

    A ogni elemento User inoltre può corrispondere un attributo denominato NoMerge. Quando viene specificato tale attributo, tutte le assegnazioni correnti delle periferiche di linea riferite all'utente vengono rimosse e ne vengono create altre nuove. È possibile utilizzare questo attributo per rimuovere facilmente le assegnazioni utente non desiderate. Per impostazione predefinita, questo attributo non è impostato.

    L'elemento User deve contenere un solo elemento DomainUserName, con il quale vengono specificati il dominio e il nome utente. L'elemento User può inoltre contenere un elemento FriendlyName, con il quale viene specificato un nome descrittivo per l'utente.

    L'elemento User può contenere un elemento LineList. Se non è presente alcun elemento LineList, verranno rimossi tutti i dispositivi di linea per l'utente.

  • Elemento LineList

    L'elemento LineList contiene informazioni su ogni linea o dispositivo assegnabile all'utente. Ogni elemento LineList può contenere più di un elemento Line. Se non è presente alcun elemento LineList, verranno rimossi tutti i dispositivi di linea per l'utente.

  • Elemento Line

    Ogni elemento Line specifica un dispositivo di linea. È necessario identificare ogni dispositivo di linea aggiungendo un elemento Address oppure un elemento PermanentID sotto l'elemento Line.

    Per ogni elemento Line è possibile impostare l'attributo Remove. Se questo attributo è impostato, all'utente non sarà più assegnata la periferica di linea corrispondente. Se questo attributo non è impostato, l'utente potrà accedere a tale periferica di linea. Se la periferica di linea non è disponibile per l'utente, non verrà visualizzato nessun errore.

Sintassi di un file XML di esempio

  • I segmenti del codice XML di esempio riportato di seguito illustrano il corretto utilizzo degli elementi descritti nei paragrafi precedenti.

    • Il codice seguente rimuove tutti i dispositivi di linea assegnati all'utente user1 utilizzando l'attributo NoMerge.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
        </User>
      </UserList>
    • Il codice seguente rimuove tutti i dispositivi di linea assegnati all'utente user1 utilizzando l'attributo NoMerge, prima di assegnare una linea con indirizzo 99999 includendo un elemento LineList con un elemento Line. All'utente user1 non saranno assegnate altre periferiche di linea, indipendentemente dal fatto che gliene fossero state assegnate o meno in precedenza.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • Il codice seguente aggiunge una periferica di linea per l'utente user1 senza eliminare nessuna periferica di linea già assegnata.

      <UserList>
        <User>
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • Il codice seguente aggiunge l'indirizzo di linea 99999 e rimuove l'indirizzo di linea 88888 dall'accesso per l'utente 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>
    • Il codice seguente aggiunge la periferica permanente 1000 e rimuove la linea 88888 dall'accesso per l'utente 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>
  • Quando si specifica l'opzione della riga di comando -d per visualizzare la configurazione corrente del server di telefonia, viene visualizzato l'output di esempio seguente. Per ogni provider di telefonia sono elencate le periferiche di linea associate, oltre agli indirizzi e agli utenti associati a ogni periferica di linea.

    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

Convenzioni di formattazione

Formato Significato

Corsivo

Informazioni che devono essere specificate dall'utente

Grassetto

Elementi che l'utente deve digitare esattamente come indicato

Elementi tra parentesi quadre ([])

Elementi facoltativi

Elementi tra parentesi graffe ({}); varie scelte separate da una barra verticale (|). Esempio: {pari|dispari}

Opzioni alternative tra le quali l'utente deve sceglierne una sola

Courier font

Codice oppure output di programmi

Ulteriori riferimenti


Argomenti della Guida