ID do artigo: 246530 - �ltima revis�o: quinta-feira, 1 de mar�o de 2007 - Revis�o: 4.2

Fun��es de scripts fornecidas pelo Iadstools.dll

Clique aqui para exibir o artigo traduzido e o artigo original em ingl�s, lado a lado.

Exibir Aviso de Isen��o de Tradu��o Autom�tica

Exibir os produtos aos quais esse artigo se aplica.

Dica do SistemaEste artigo aplica-se a um sistema operativo diferente do que est� a utilizar. Foi desactivado o conte�do do artigo, que pode n�o ser relevante para si.

Iadstools.dll � uma biblioteca de v�nculo din�mico (DLL) que voc� pode usar para escrever scripts do Microsoft Visual Basic (ou criar seus pr�prios programas) para extrair tipos espec�ficos de dados do Active Directory e tirar proveito do novo aplicativo programa��o chamadas de API (interface) que est�o dispon�veis no Windows 2000. Por exemplo, Iadstools.dll inclui fun��es que facilitam o script de replica��o entre controladores de dom�nio com apenas algumas linhas de c�digo do VBScript.

Iadstools.dll � instalado com o pacote de ferramentas de suporte do Windows 2000, que voc� pode instalar a partir da pasta Support\Tools no CD-ROM Professional do Windows 2000 Server ou. Para obter uma lista completa de todas as fun��es dispon�veis no Iadstools.dll, consulte o arquivo Iadstools.doc que � instalado com o pacote de ferramentas de suporte do Windows 2000.

Voltar para o in�cio

Mais Informa��es

Descri��o das fun��es

DsGetDcName : A nova API de 2000 do Windows que permite localizar baseado no Windows NT 4.0 e controladores de dom�nio baseados no Windows 2000 com requisitos de vari�veis e muito mais flexibilidade.

ReplicaSync : inicia replica��o entre dois controladores de dom�nio para uma determinada parti��o de diret�rio.

ReplicaSyncAll : inicia a duplica��o para colocar um controlador de dom�nio espec�fico atualizado em rela��o a todos os outros controladores de dom�nio ou para envio muda de um controlador de dom�nio para todos os outros.

TriggerKCC : dispara o Knowledge Consistency Checker (KCC) no servidor especificado para verificar a topologia atual para garantir que ele tem considerados todas as altera��es recentes.

GetGCList : gera uma lista de servidores de cat�logo global da empresa.

GetDirectPartnersEx : Retorna o nome e o status dos parceiros de replica��o direta do controlador de dom�nio especificado.

GetReplicationUSNStateEx : Retorna a nome e a atualiza��o de seq��ncia de n�mero (USN) de parceiros de duplica��o direto e transitivas.

GetChangeNotifications : retorna os controladores de dom�nio que o servidor especificado notifica quando ocorreram altera��es que precisam ser duplicadas.

GetRidPoolFSMO : consulta o servidor especificado para o que acredita que � o propriet�rio FSMO de pool RID.

GetDomainNamingFSMO : consulta o servidor especificado para o que acredita que � o propriet�rio FSMO de gerenciamento de �rvore de dom�nio.

GetSchemaFSMO : consulta o servidor especificado para o que acredita que � o propriet�rio FSMO de esquema.

GetPDCFSMO : consulta o servidor especificado para o que acredita que � o propriet�rio do PDC FSMO.

GetInfrastructureFSMO : consulta o servidor especificado para o que acredita que � o propriet�rio FSMO de infra-estrutura.

GetHighestCommittedUSN : dado um controlador de dom�nio, ele recebe o USN mais alto confirmado para o servidor.

GetGPOs : enumera os objetos de diretiva de grupo (GPOs) para um determinado controlador de dom�nio.

GetGPOVersion : determina a vers�o de um GPO espec�fico no Active Directory em um controlador de dom�nio espec�fico.

GetGPOSysVolVersion : determina a vers�o de um GPO espec�fico no SYSVOL em um controlador de dom�nio espec�fico.

GetConfigurationNamingContext : determina o nome da parti��o de diret�rio configura��o para um controlador de dom�nio.

GetDefaultNamingContext : determina o nome da parti��o de diret�rio padr�o (dom�nio) para um determinado controlador de dom�nio.

GetMetaData : retorna os metadados de atributo para um objeto espec�fico no Active Directory.

GetDSAConnections : gera uma lista de objetos de conex�o NTDS e suas propriedades para um determinado servidor.

GetSiteList : gera uma lista de sites um servidor do qual os dados de origem.

GetSiteLinks : gera uma lista de links de site fornecidos um servidor do qual os dados de origem.

GetSiteLinkBridges : gera uma lista de pontes de links fornecido um servidor do qual os dados de origem.

GetSiteLinkBridgeProperties : consultas do Active Directory para a configura��o de uma ponte de link determinado site.

GetSiteLinkProperties : consultas do Active Directory para a configura��o de um determinado link de site.

GetSiteProperties : consultas do Active Directory para a configura��o de um determinado site.

GetInterSiteTransports : consultas do Active Directory para a configura��o dos transportes de duplica��o IP e o SMTP Active Directory.

GetSiteForServer : resolve o site do qual o controlador de dom�nio especificado � um membro.

GetBridgeHeadsInSite : enumera os controladores de dom�nio atuando como pontes em um determinado site.

GetInterSiteTopologyGenerator : dado um site, obt�m o nome �nico parte (do nome distinto) do computador que possui a fun��o de cria��o/manter os objetos de conex�o entre sites para todos os servidores em um site.

DsGetSiteName : A nova API de 2000 do Windows para localizar o site do computador consultado para.

GetSubnets : consultas do Active Directory para uma enumera��o e a configura��o de sub-redes.

GetServersInSite : enumera os controladores de dom�nio um determinado site.

GetTrustRelationships : Retorna a configura��o de rela��es de confian�a para o dom�nio no qual reside o controlador de dom�nio conectado a.

GetDSAProperties : consultas do Active Directory para a configura��o das configura��es de NTDS um controlador de dom�nio espec�fico.

DsGetDcList : obt�m a lista de controladores de dom�nio e propriedades associadas de um determinado dom�nio.

GetIPConfiguration : determina a configura��o de IP (incluindo o endere�o IP, DNS, etc.) do servidor especificado.

GetServersInSiteWithWritableNC : enumera os controladores de dom�nio um determinado site com uma parti��o de diret�rio grav�vel.

GetNamingContexts : Leituras RootDSE de um controlador de dom�nio especificado para determinar as parti��es de diret�rio que ele mant�m.

GetWritableNCsForServer : Leituras RootDSE de um controlador de dom�nio especificado para determinar as parti��es de diret�rio que ele mant�m.

GetPartialNamingContexts : Leituras RootDSE de um controlador de dom�nio especificado para determinar as parti��es de diret�rio de c�pia parcial que ele mant�m.

ConvertErrorMsg : converte um n�mero de erro para texto da mensagem.

GetActiveDirectoryProperties : consultas do Active Directory para par�metros de configura��o gerais.

GetRegistryData : recupera um valor do registro de um computador local ou remoto.

GetServerFromGuid : resolve um nome de servidor de um especificado global unique ID (GUID).

GetGuidForServer : consultas do Active Directory para o GUID (banco de dados GUID) de um determinado servidor.

GetObjectGuidForServer : consultas do Active Directory para o objeto GUID de um determinado servidor.

GetObjectFromGuid : resolve um objeto no Active Directory de um GUID do objeto especificado.

TranslateDNToNT4 : converte o nome distinto de uma conta de usu�rio (cn = administrador, cn = usu�rios,...) para um formato de dom�nio\usu�rio 4.0 estilo Windows NT (conseguido por meio da ADSI).

TranslateNT4ToDN : converte credenciais do Windows NT 4.0 estilo (dom�nio\usu�rio) um nome distinto por procurar a conta e ler o nome distinto identifica esse objeto (conseguido por meio da ADSI).

GetPerformanceData : o valor atual dos contadores carregado no InitPerformanceData leituras.

Voltar para o in�cio

Exemplos

Sincronizar controladores de dom�nio

Esse script dispara uma sincroniza��o em "server1", recebendo as altera��es de "Servidor2" que foram registradas para as informa��es de configura��o (inclui sites, sub-redes e dados do controlador de dom�nio):

Set DLL=CreateObject("IADsTools.DCFunctions")
Result=DLL.ReplicaSync("server1","cn=configuration,dc=mydomain,dc=com","server2")
if result=-1 Then
     Wscript.Echo "The error returned was: " + DLL.LastErrorText
else
     Wscript.Echo "The command completed successfully."
end if

se voc� usar vari�veis no seu script, ele parece um pouco diferente:

Dim TargetServer
Dim SourceServer
Dim NamingContext

TargetServer="server1"
SourceServer="server2"
NamingContext="cn=configuration,dc=mydomain,dc=com"

Set DLL=CreateObject("IADsTools.DCFunctions")
Result=DLL.ReplicaSync(Cstr(TargetServer),Cstr(NamingContext),Cstr(SourceServer))
if result=-1 Then
     Wscript.Echo "The error returned was: " + DLL.LastErrorText
else
     Wscript.Echo "The command completed successfully."
end if

Obter a lista de servidores de cat�logo global da empresa

Esse script usa "server1" como a fonte de informa��es e obt�m a lista de servidores de cat�logo global na empresa dele:

Set DLL=CreateObject("IADsTools.DCFunctions")
Result=DLL.GetGCList("server1")
if result=-1 Then
     Wscript.echo "The error returned was: " + DLL.LastErrorText
else
     Wscript.echo "The number of Global Catalog servers returned is: " + cstr(result)
     wscript.echo "----------------------------------------------------"
     for i=1 to Result
          'print out the name of each GC server
          wscript.echo DLL.GCName(i)
     next
end if

Enumerar controladores de dom�nio e procurar problemas de replica��o

Esse script contata cada controlador de dom�nio em um dom�nio e verifica para obter quaisquer problemas de replica��o. Esse script combina fun��es que enumerar a lista de controladores de dom�nio, enumerar a lista de parti��es de diret�rio em cada um desses controladores de dom�nio e verificar o status de replica��o de cada parti��o de diret�rio para problemas:

Set DLL=CreateObject("IADsTools.DCFunctions")
'read the list of domain controllers
Result=DLL.DsGetDCList("server1","mydomain.com",1)
if result=-1 Then
     Wscript.echo "The error returned was: " + DLL.LastErrorText
else
     Wscript.echo "The number of Domain Controllers returned is: " + cstr(result)
     wscript.echo "--------------------------------------------------"
     for i=1 to Result
          'for each domain controller, get the number of Directory Partitions (non-partial) it hosts
          wscript.echo "Checking domain controller: " + DLL.DCListEntryNetBiosName(i)
          PartitionResult=DLL.GetNamingContexts(DLL.DCListEntryNetBiosName(i))
          'if we couldn't reach the server, skip it
          if PartitionResult=-1 then
               wscript.echo "Could not reach the server: " + DLL.DCListEntryNetBiosName(i)
          else
               wscript.echo "Found " + CStr(PartitionResult) + " Directory Partitions (non-partial) on (" + DLL.DCListEntryNetBiosName(i) + ")."
               'query the status of each directory partition
               for j=1 to PartitionResult
                    ReplResult=DLL.GetDirectPartnersEx(DLL.DCListEntryNetBiosName(i),DLL.NamingContextName(j), 0)
                    'see if there's a failure code other than zero for any of the replication partners
                    for k=1 to ReplResult
                         if DLL.DirectPartnerFailReason(k) > 0 then
                              wscript.echo "Failure detected replicating partition (" + DLL.NamingContextName(j) + ") from (" + DLL.DirectPartnerName(k) + ")."
                         else
                              'if you wanted to enable the following line, you could see the ones that are OK as well
                              'wscript.echo "OK --- Replicating partition (" + DLL.NamingContextName(j) + ") from (" + DLL.DirectPartnerName(k) + ")."
                         end if
                    next
                next
          end if
     next
end if

Voltar para o in�cio

A informa��o contida neste artigo aplica-se a:

Microsoft Windows 2000 Server
Microsoft Windows 2000 Advanced Server
Microsoft Windows 2000 Professional Edition
Microsoft Windows 2000 Datacenter Server

Voltar para o in�cio

kbmt kbinfo KB246530 KbMtpt

Voltar para o in�cio

Tradu��o autom�tica

IMPORTANTE: Este artigo foi traduzido por um sistema de tradu��o autom�tica (tamb�m designado por Machine Translation ou MT), n�o tendo sido portanto traduzido ou revisto por pessoas. A Microsoft possui artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais, com o objetivo de oferecer em portugu�s a totalidade dos artigos existentes na base de dados de suporte. No entanto, a tradu��o autom�tica n�o � sempre perfeita, podendo conter erros de vocabul�rio, sintaxe ou gram�tica. A Microsoft n�o � respons�vel por incoer�ncias, erros ou preju�zos ocorridos em decorr�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza atualiza��es freq�entes ao software de tradu��o autom�tica (MT). Obrigado.

Clique aqui para ver a vers�o em Ingl�s deste artigo: 246530� (http://support.microsoft.com/kb/246530/en-us/ )

Voltar para o in�cio