Artigo: 246530 - �ltima revis�o: quinta-feira, 1 de Mar�o de 2007 - Revis�o: 4.2

Fun��es de processamento de scripts fornecidas pela Iadstools.dll

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

Ver isen��o de responsabilidades para tradu��o autom�tica

Ver produtos para os quais este 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 liga��o din�mica (DLL) que pode utilizar para escrever scripts do Microsoft Visual Basic (ou criar os seus pr�prios programas) para extrair tipos espec�ficos de dados do Active Directory e para tirar partido da nova aplica��o programa��o chamadas de API que est�o dispon�veis no Windows 2000. Por exemplo, Iadstools.dll inclui fun��es que facilitam a replica��o entre controladores de dom�nio com apenas algumas linhas de c�digo VBScript de script.

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

Voltar ao topo

Mais Informa��o

Descri��o de fun��es

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

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

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

TriggerKCC : activa o Verificador de consist�ncia de conhecimento (KCC) no servidor especificado para verificar a topologia actual para garantir que tem contabilizados para que as recentes altera��es.

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

GetDirectPartnersEx : devolve o nome e o estado dos parceiros de replica��o directa do controlador de dom�nio especificado.

GetReplicationUSNStateEx : devolve a nome e a actualiza��o de sequ�ncia de n�mero (USN) de parceiros de replica��o directa e transitivas.

GetChangeNotifications : devolve a controladores de dom�nio que o servidor especificado notifica quando altera��es ocorreram que precisam de ser replicadas.

GetRidPoolFSMO : consulta o servidor especificado para que julgue � o propriet�rio do FSMO de conjunto de RID.

GetDomainNamingFSMO : consulta o servidor especificado para que julgue � o propriet�rio do FSMO de gest�o de �rvore de dom�nios.

GetSchemaFSMO : consulta o servidor especificado para que julgue � o propriet�rio do FSMO do esquema.

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

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

GetHighestCommittedUSN : fornecidos um controlador de dom�nio, que recebe o USN mais alto consolidado para o servidor.

GetGPOs : Enumera os objectos de pol�tica de grupo (GPO, Group Policy Objects) para um controlador de dom�nio especificado.

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

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

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

GetDefaultNamingContext : determina o nome da parti��o de direct�rio predefinido (dom�nio) de um controlador de dom�nio especificado.

GetMetaData : devolve os metadados de atributo para um determinado objecto no Active Directory.

GetDSAConnections : gera uma lista de objectos de liga��o NTDS e respectivas propriedades para um determinado servidor.

GetSiteList : gera uma lista de sites atribu�do um servidor a partir do qual os dados de origem.

GetSiteLinks : gera uma lista das liga��es de locais atribu�das um servidor a partir do qual os dados de origem.

GetSiteLinkBridges : gera uma lista de pontes de liga��o a sites atribu�do um servidor a partir do qual os dados de origem.

GetSiteLinkBridgeProperties : consulta do Active Directory para a configura��o de uma determinada liga��o bridge de site.

GetSiteLinkProperties : consultas do Active Directory para a configura��o de uma liga��o de site especificado.

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

GetInterSiteTransports : consulta do Active Directory para a configura��o de IP e o SMTP Active Directory transportes de replica��o.

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

GetBridgeHeadsInSite : Enumera os controladores de dom�nio que actua como bridgeheads num determinado site.

GetInterSiteTopologyGenerator : indicado um site, obt�m o nome s� parte (do nome distinto) do computador que det�m a fun��o de cria��o/manter os objectos de liga��o entre locais para todos os servidores num site.

DsGetSiteName : O novo 2000 API do Windows para localizar o site do computador consultado.

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

GetServersInSite : Enumera os controladores de dom�nio um determinado local.

GetTrustRelationships : devolve a configura��o de rela��es de fidedignidade para o dom�nio no qual reside o controlador de dom�nio ligado ao.

GetDSAProperties : consulta do Active Directory para a configura��o das defini��es de NTDS (NTDS Settings) de um controlador de dom�nio espec�fico.

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

GetIPConfiguration : determina a configura��o 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 direct�rio grav�vel.

GetNamingContexts : l� o RootDSE de um controlador de dom�nio especificado para determinar as parti��es de direct�rio � mantida.

GetWritableNCsForServer : l� o RootDSE de um controlador de dom�nio especificado para determinar as parti��es de direct�rio � mantida.

GetPartialNamingContexts : o RootDSE de um controlador de dom�nio especificado para determinar as parti��es de direct�rio de c�pia parcial que mant�m as leituras.

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

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

GetRegistryData : obt�m um valor de registo a partir de um computador remoto ou local.

GetServerFromGuid : resolve um nome de servidor a partir de um especificado exclusivo global ID (GUID).

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

GetObjectGuidForServer : consulta do Active Directory para o objecto GUID de um determinado servidor.

GetObjectFromGuid : resolve um objecto no Active Directory de um GUID de objecto especificado.

TranslateDNToNT4 : converte o nome distinto de uma conta de utilizador (cn = administrador, cn = utilizadores,...) num formato de dom�nio\utilizador 4.0 estilo Windows NT (conseguido atrav�s da ADSI).

TranslateNT4ToDN : converte o Windows NT 4.0 estilo credenciais (dom�nio\utilizador) para um nome distinto procurar a conta e lendo o nome distinto identifica o objecto (conseguido atrav�s da ADSI).

GetPerformanceData : o valor actual de contadores carregado no InitPerformanceData leituras.

Voltar ao topo

Exemplos

Sincronizar os controladores de dom�nio

Este script acciona uma sincroniza��o "dedicado ao servidor1," Transferir altera��es de "Servidor2" que foram registadas 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 utilizar vari�veis no seu script, parece ligeiramente 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 de empresa

Este script utiliza "server1" como a origem de informa��es e obt�m a lista de servidores de cat�logo global da empresa a partir do mesmo:

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 os controladores de dom�nio e verificar exist�ncia de problemas de replica��o

Este script contacta cada controlador de dom�nio no dom�nio e verifica��es para obter quaisquer problemas de replica��o. Este script combina fun��es que enumerar a lista de controladores de dom�nio, enumerar a lista de parti��es de direct�rio em cada uma desses controladores de dom�nio e verificar o estado de replica��o de cada parti��o de direct�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 ao topo

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 ao topo

kbmt kbinfo KB246530 KbMtpt

Voltar ao topo

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 revisto ou traduzido por humanos. A Microsoft tem artigos traduzidos por aplica��es (MT) e artigos traduzidos por tradutores profissionais. O objectivo � simples: oferecer em Portugu�s a totalidade dos artigos existentes na base de dados do suporte. Sabemos no entanto que a tradu��o autom�tica n�o � sempre perfeita. Esta pode conter erros de vocabul�rio, sintaxe ou gram�tica? erros semelhantes aos que um estrangeiro realiza ao falar em Portugu�s. A Microsoft n�o � respons�vel por incoer�ncias, erros ou estragos realizados na sequ�ncia da utiliza��o dos artigos MT por parte dos nossos clientes. A Microsoft realiza actualiza��es frequentes 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 ao topo

This site in other countries/regions:

Fun��es de processamento de scripts fornecidas pela Iadstools.dll

Nesta p�gina

Sum�rio

Mais Informa��o

Descri��o de fun��es

Exemplos

Sincronizar os controladores de dom�nio

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

Enumerar os controladores de dom�nio e verificar exist�ncia de problemas de replica��o

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

Palavras-chave:�

Fornecer coment�rios sobre estas informa��es

Outros Sites de Suporte

Comunidades

Tradu��es de Artigos

Centros de suporte relacionados