TSecImp importa informações sobre atribuição de linhas e telefones de um arquivo XML para o arquivo de segurança do servidor de telefonia (Tsec.ini). Você também pode usar esse comando para exibir a lista de provedores de serviços de telefonia e os dispositivos e linhas associados a cada um deles, validar a estrutura do arquivo XML sem a importação do conteúdo e verificar a associação no domínio dos usuários para os quais deseja adicionar permissões.

Para importar um arquivo XML para o arquivo Tsec.ini

Sintaxe

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

Parâmetros
-f Nome_do_arquivo
Obrigatório. Especifica o nome do arquivo XML que contém as informações sobre atribuição que você deseja importar.

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

-u
Verifica se cada usuário é membro do domínio especificado no arquivo XML. O computador no qual este parâmetro for utilizado deverá estar conectado à rede. Este parâmetro pode reduzir consideravelmente o desempenho caso você esteja processando uma grande quantidade de informações sobre atribuição a usuários.

Para exibir provedores de serviços de telefonia com seus respectivos dispositivos e linhas

Sintaxe

tsecimp -d

Parâmetros
-d
Exibe uma lista de provedores de telefonia instalados. Para cada provedor de telefonia, são listados os dispositivos de linha associados, bem como os usuários e endereços IP associados a cada dispositivo de linha.

Estrutura do arquivo XML

O arquivo XML do qual você deseja importar informações sobre atribuição deve seguir a estrutura descrita abaixo.

  • Elemento Lista_de_Usuários

    Lista_de_Usuário é o elemento principal do arquivo XML.

  • Elemento Usuário

    Cada elemento Usuário contém informações sobre um usuário que é membro de um domínio. Cada usuário pode receber um ou mais dispositivos de linha.

    Além disso, cada elemento Usuário pode ter um atributo chamado NoMerge. Quando esse atributo está especificado, todas as atribuições atuais de dispositivos de linha referentes ao usuário são removidas antes que novas sejam feitas. Você pode usá-lo para remover atribuições indesejadas a usuários. Por padrão, esse atributo não está definido.

    O elemento Usuário deve conter um único elemento Nome_de_Usuário_do_Domínio, que especifica o domínio e o nome do usuário. O elemento Usuário também pode conter um elemento Nome_Amigável, que especifica um nome amigável para o usuário.

    O elemento Usuário pode conter um elemento Lista_de_Linhas. Se um elemento Lista_de_Linhas não estiver presente, todos os dispositivos de linha referentes a este usuário serão removidos.

  • Elemento Lista_de_Linhas

    O elemento Lista_de_Linhas contém informações sobre cada linha ou dispositivo que possa ser atribuído ao usuário. Cada elemento Lista_de_Linhas pode conter mais de um elemento Linha. Se um elemento Lista_de_Linhas não estiver presente, todos os dispositivos de linha referentes a este usuário serão removidos.

  • Elemento Linha

    Cada elemento Linha especifica um dispositivo de linha. Você deve identificar cada dispositivo de linha adicionando um elemento Endereço ou um elemento ID_Permanente no elemento Linha.

    Para cada elemento Linha, você pode definir o atributo Remover. Se você definir esse atributo, o dispositivo de linha não será mais atribuído ao usuário. Caso contrário, o usuário terá acesso ao dispositivo de linha. Nenhum erro será relatado a você se o dispositivo de linha não estiver disponível para o usuário.

Sintaxe do arquivo XML de exemplo

  • Os segmentos de código XML de exemplo a seguir ilustram o uso correto dos elementos definidos acima.

    • O código a seguir remove todos os dispositivos de linha atribuídos ao Usuário1 com o uso do atributo NoMerge.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
        </User>
      </UserList>
    • O código a seguir remove todos os dispositivos de linha atribuídos a Usuário1 com o uso do atributo NoMerge, antes de atribuir uma linha com o endereço 99999 incluindo um Lista_de_Linhas com um elemento Linha. Usuário1 não receberá nenhum dispositivo de linha, independentemente de algum dispositivo de linha ter sido atribuído anteriormente.

      <UserList>
        <User NoMerge="1">
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • O código a seguir adiciona um dispositivo de linha para Usuário1 sem excluir nenhum dispositivo de linha atribuído anteriormente.

      <UserList>
        <User>
          <DomainUser>domain1\user1</DomainUser>
          <FriendlyName>User1</FriendlyName>
          <LineList>
            <Line>
              <Address>99999</Address>
            </Line>
          </LineList>
        </User>
      </UserList>
    • O código a seguir adiciona o endereço de linha 99999 e remove o endereço de linha 88888 do acesso pelo Usuário1.

      <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 a seguir adiciona o dispositivo permanente 1000 e remove a linha 88888 do acesso pelo Usuário1.

      <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 do exemplo a seguir aparece depois que a opção de linha de comando -d é especificada para exibir a configuração atual do servidor de telefonia. Para cada provedor de telefonia, são listados os dispositivos de linha associados, bem como os usuários e endereços 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 da formatação

Formato Significado

Itálico

Informações que devem ser fornecidas pelo usuário

Negrito

Elementos que o usuário deve digitar exatamente conforme mostrado

Entre colchetes ([])

Itens opcionais

Entre chaves ({}); opções separadas por barra vertical (|). Exemplo: {even|odd}

Conjunto de opções entre as quais o usuário deve escolher apenas uma

Courier font

Saída de código ou de programa

Referências adicionais


Sumário