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>
-
O código a seguir remove todos os dispositivos de linha atribuídos ao Usuário1 com o uso do atributo NoMerge.
-
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 |
|
Saída de código ou de programa |