O TSecImp importa informações de atribuição de linhas e telefones de um ficheiro XML para o ficheiro de segurança do servidor de telefonia (Tsec.ini). Também pode utilizar este comando para visualizar a lista de fornecedores de serviços de telefonia e as linhas e dispositivos associados a cada um, validar a estrutura do ficheiro XML sem importar o conteúdo e verificar a associação do domínio dos utilizadores aos quais pretende adicionar permissões.

Para importar um ficheiro XML para o ficheiro Tsec.ini

Sintaxe

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

Parâmetros
-f NomeFicheiro
Obrigatório. Especifica o nome do ficheiro XML que contém as informações de atribuição que pretende importar.

-v
Valida a estrutura do ficheiro XML sem importar as informações para o ficheiro Tsec.ini.

-u
Verifica se cada utilizador é membro do domínio especificado no ficheiro XML. O computador no qual o utilizador utiliza este parâmetro tem de estar ligado à rede. Este parâmetro poderá abrandar significativamente o desempenho se o utilizador estiver a processar uma grande quantidade de informações de atribuição do utilizador.

Para visualizar os fornecedores de serviços de telefonia com as respectivas linhas e dispositivos

Sintaxe

tsecimp -d

Parâmetros
-d
Apresenta uma lista de fornecedores de telefonia instalados. Para cada fornecedor de telefonia, estão listados os dispositivos de linha associados, bem como os endereços IP e utilizadores associados a cada dispositivo de linha.

Estrutura do ficheiro XML

O ficheiro XML a partir do qual pretende importar informações de atribuição tem de seguir a estrutura descrita abaixo.

  • Elemento UserList

    O UserList é o elemento principal do ficheiro XML.

  • Elemento User

    Cada elemento User contém informações sobre um utilizador membro de um domínio. É possível atribuir um ou mais dispositivos de linha a cada utilizador.

    Além disso, cada elemento User poderá ter um atributo denominado NoMerge. Quando este atributo é especificado, todas as atribuições de dispositivos de linha actuais para o utilizador são removidas antes de serem criadas novas atribuições. Pode utilizar este atributo para remover facilmente atribuição de utilizador não pretendidas. Por predefinição, este atributo não está definido.

    O elemento User tem de conter um elemento DomainUserName único, que especifique o nome de utilizador e domínio do utilizador. O elemento User poderá conter também um elemento FriendlyName, que especifique um nome amigável para o utilizador.

    O elemento User poderá conter um elemento LineList. Se um elemento LineList não estiver presente, todos os dispositivos de linha para este utilizador serão removidos.

  • Elemento LineList

    O elemento LineList contém informações sobre cada linha ou dispositivo que possa estar atribuído ao utilizador. Cada elemento LineList pode conter mais do que um elemento Line. Se um elemento LineList não estiver presente, todos os dispositivos de linha para este utilizador serão removidos.

  • Elemento Line

    Cada elemento Line especifica um dispositivo de linha. Tem de identificar cada dispositivo de linha através da adição de um elemento Address ou de um elemento PermanentID no elemento Line.

    Para cada elemento Line, pode definir o atributo Remove. Se definir este atributo, o dispositivo de linha deixa de estar atribuído ao utilizador. Se este atributo não for definido, o utilizador obtém acesso a esse dispositivo de linha. Não é reportado qualquer erro ao utilizador se o dispositivo de linha não estiver disponível para o utilizador.

Sintaxe do ficheiro XML de amostra

  • Os segmentos de código XML de amostra ilustram a utilização correcta dos elementos definidos acima.

    • O código que se segue remove todos os dispositivos de linha atribuídos ao Utilizador1 através do atributo NoMerge.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
        </User>
      </UserList>
    • O código que se segue remove todos os dispositivos de linha atribuídos ao Utilizador1 através do atributo NoMerge, antes de atribuir uma linha com o endereço 99999, incluindo LineList com um elemento Line. O Utilizador1 não terá outros dispositivos de linha atribuídos, independentemente se os dispositivos de linha foram atribuídos anteriormente.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • O código que se segue adiciona um dispositivo de linha para o Utilizador1 sem eliminar os dispositivos de linha anteriormente atribuídos.

      <UserList>
        <User>
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • O código que se segue adiciona o endereço de linha 99999 e remove o endereço de linha 88888 do acesso do Utilizador1.

      <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>
    • O código que se segue adiciona o dispositivo permanente 1000 e remove a linha 88888 do acesso do Utilizador1.

      <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>
  • A saída de amostra que se segue aparece depois de a opção da linha de comandos -d ser especificada para apresentar a configuração do servidor de telefonia actual. Para cada fornecedor de telefonia, são listados os dispositivos de linha associados, bem como os endereços e utilizadores associados a cada dispositivo de linha.

    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

Legenda de formatação

Formatação Significado

Itálico

Informações que o utilizador tem de fornecer

Negrito

Elementos que o utilizador tem de escrever exactamente como são apresentados

Entre parênteses rectos ([])

Itens opcionais

Entre chavetas ({}); opções separadas por uma barra vertical (|). Exemplo: {par|ímpar}

Conjunto de opções do qual o utilizador deve escolher apenas uma

Courier font

Código ou saída do programa

Referências adicionais


Sumário