Microsoft Entra Connect: Referência do PowerShell do ADSyncTools

Artigo
11/06/2023

A documentação a seguir fornece informações de referência sobre o módulo ADSyncTools.psm1 do PowerShell que está incluído no Microsoft Entra Connect.

Instalar o módulo do PowerShell do ADSyncTools

Para instalar o módulo do PowerShell do ADSyncTools, faça o seguinte:

Abrir o Windows PowerShell com privilégios administrativos

Digite ou copie e cole o seguinte:

    [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
    Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
    Import-module -Name "C:\Program Files\Microsoft Azure Active Directory Connect\Tools\AdSyncTools"

Pressione Enter.
Para verificar se o módulo foi instalado, insira ou copie e cole o seguinte"
```
Get-module AdSyncTools
```
Agora, você deve ver informações sobre o módulo.

Clear-ADSyncToolsMsDsConsistencyGuid

SINOPSE

Limpar um mS-DS-ConsistencyGuid de objeto do AD DS

SYNTAX

Clear-ADSyncToolsMsDsConsistencyGuid [-Identity] <Object> [<CommonParameters>]

DESCRIPTION

Limpa o valor em mS-DS-ConsistencyGuid do objeto de destino do AD DS. Permite objetos do Active Directory em florestas de vários domínios.

EXEMPLOS

EXEMPLO 1

Clear-ADSyncToolsMsDsConsistencyGuid -Identity 'CN=User1,OU=Sync,DC=Contoso,DC=com'

EXEMPLO 2

Clear-ADSyncToolsMsDsConsistencyGuid -Identity 'User1@Contoso.com'

EXEMPLO 3

'User1@Contoso.com' | Clear-ADSyncToolsMsDsConsistencyGuid

PARAMETERS

-Identity

Objeto de destino no AD para limpar mS-DS-ConsistencyGuid

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Este cmdlet oferece suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.

Connect-ADSyncToolsSqlDatabase

SINOPSE

Conecta um banco de dados SQL para fins de teste

SYNTAX

Connect-ADSyncToolsSqlDatabase [-Server] <String> [[-Instance] <String>] [[-Database] <String>]
 [[-Port] <String>] [[-UserName] <String>] [[-Password] <String>] [<CommonParameters>]

DESCRIPTION

Funções e utilitários relacionados a diagnóstico de SQL

EXEMPLOS

EXEMPLO 1

Connect-ADSyncToolsSqlDatabase -Server 'sqlserver01.contoso.com' -Database 'ADSync'

EXEMPLO 2

Connect-ADSyncToolsSqlDatabase -Server 'sqlserver01.contoso.com' -Instance 'INTANCE01' -Database 'ADSync'

PARAMETERS

-Server

Nome do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Instance

Nome da instância do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Database

Nome do banco de dados do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Port

Porta do SQL Server (ex.:49823)

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserName

Nome de usuário de logon do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Password

Senha de logon do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

ConvertFrom-ADSyncToolsAadDistinguishedName

SINOPSE

Converter DistinguishedName do Microsoft Entra Connect em ImmutableId

SYNTAX

ConvertFrom-ADSyncToolsAadDistinguishedName [-DistinguishedName] <String> [<CommonParameters>]

DESCRIPTION

Obtém o DistinguishedName de um Microsoft Entra Connector, como CN={514635484D4B376E38307176645973555049486139513D3D}, e converte para o valor de ImmutableID base64 respectivo, por exemplo, QF5HMK7n80qvdYsUPIHa9Q==

EXEMPLOS

EXEMPLO 1

ConvertFrom-ADSyncToolsAadDistinguishedName 'CN={514635484D4B376E38307176645973555049486139513D3D}'

PARAMETERS

-DistinguishedName

DistinguishedName do espaço do conector do Microsoft Entra Connect

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

ConvertFrom-ADSyncToolsImmutableID

SINOPSE

Converter ImmutableId (SourceAnchor) Base64 para o valor do GUID

SYNTAX

ConvertFrom-ADSyncToolsImmutableID [-Value] <String> [<CommonParameters>]

DESCRIPTION

Converte o valor de ImmutableID da cadeia de caracteres Base64 e retorna um valor de GUID. Caso a cadeia de caracteres Base64 não possa ser convertida em GUID, retorna uma matriz de bytes.

EXEMPLOS

EXEMPLO 1

ConvertFrom-ADSyncToolsImmutableID 'iGhmiAEBERG7uxI0VniQqw=='

EXEMPLO 2

'iGhmiAEBERG7uxI0VniQqw==' | ConvertFrom-ADSyncToolsImmutableID

PARAMETERS

-Value

ImmutableId no formato Base64

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

ConvertTo-ADSyncToolsAadDistinguishedName

SINOPSE

Converte ImmutableId em DistinguishedName do conector do Microsoft Entra Connect

SYNTAX

ConvertTo-ADSyncToolsAadDistinguishedName [-ImmutableId] <String> [<CommonParameters>]

DESCRIPTION

Obtém um ImmutableId (SourceAnchor) como QF5HMK7n80qvdYsUPIHa9Q== e converte para o respectivo valor de DistinguishedName do Microsoft Entra Connector, ex.: CN={514635484D4B376E38307176645973555049486139513D3D}

EXEMPLOS

EXEMPLO 1

ConvertTo-ADSyncToolsAadDistinguishedName 'QF5HMK7n80qvdYsUPIHa9Q=='

PARAMETERS

-ImmutableId

ImmutableId (SourceAnchor)

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

ConvertTo-ADSyncToolsCloudAnchor

SINOPSE

Converter âncora Base64 para CloudAnchor

SYNTAX

ConvertTo-ADSyncToolsCloudAnchor [-Anchor] <String> [<CommonParameters>]

DESCRIPTION

Usa uma âncora Base64 como VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA== e converte para o valor CloudAnchor respectivo, por exemplo, User_abc12345-1234-abcd-9876-ab0123456789

EXEMPLOS

EXEMPLO 1

ConvertTo-ADSyncToolsCloudAnchor "VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA=="

EXEMPLO 2

"VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA==" | ConvertTo-ADSyncToolsCloudAnchor

PARAMETERS

-Anchor

Âncora Base64

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

ConvertTo-ADSyncToolsImmutableID

SINOPSE

Converter GUID (objectGUID/ms-DS-Consistency-GUID) em uma cadeia de caracteres Base64

SYNTAX

ConvertTo-ADSyncToolsImmutableID [-Value] <Object> [<CommonParameters>]

DESCRIPTION

Converte um valor em GUID, cadeia de caracteres de GUID ou formato de matriz de bytes em uma cadeia de caracteres Base64

EXEMPLOS

EXEMPLO 1

ConvertTo-ADSyncToolsImmutableID '88888888-0101-3333-cccc-1234567890cd'

EXEMPLO 2

'88888888-0101-3333-cccc-1234567890cd' | ConvertTo-ADSyncToolsImmutableID

PARAMETERS

-Value

GUID, cadeia de caracteres de GUID ou matriz de bytes

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Export-ADSyncToolsAadDisconnectors

SINOPSE

Exportar objetos do Microsoft Entra Disconnector

SYNTAX

Export-ADSyncToolsAadDisconnectors [[-SyncObjectType] <Object>] [<CommonParameters>]

DESCRIPTION

Executa a ferramenta CSExport para exportar todos os desconectadores para XML e, em seguida, usa essa saída XML e a converte em um arquivo CSV com: UserPrincipalName, Mail, SourceAnchor, DistinguishedName, CsObjectId, ObjectType, ConnectorId, CloudAnchor

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsAadDisconnectors -SyncObjectType 'PublicFolder'

Exporta para CSV todos os objetos do desconectador PublicFolder

EXEMPLO 2

Export-ADSyncToolsAadDisconnectors

Exporta para CSV todos os objetos do desconectador

PARAMETERS

-SyncObjectType

ObjectType para incluir na saída

Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

ENTRADAS

Use o argumento ObjectType caso queira exportar desconectadores somente para um determinado tipo de objeto

SAÍDAS

Exporta um arquivo CSV com objetos de Desconectador que contêm: UserPrincipalName, Mail, SourceAnchor, DistinguishedName, CsObjectId, ObjectType, ConnectorId e CloudAnchor

Export-ADSyncToolsAadPublicFolders

SINOPSE

Exporta todos os objetos de Pasta Pública Habilitada para Email sincronizados do Microsoft Entra ID para um arquivo CSV

SYNTAX

Export-ADSyncToolsAadPublicFolders [-Credential] <PSCredential> [-Path] <Object> [<CommonParameters>]

DESCRIPTION

Essa função exporta para um arquivo CSV todos os MEPF (Pastas Públicas Habilitadas para Email) sincronizados presentes no Microsoft Entra ID. Ele pode ser usado em conjunto com Remove-ADSyncToolsAadPublicFolders para identificar e remover Pastas Públicas Habilitadas para Email órfãs no Microsoft Entra ID. Essa função requer as credenciais de um Administrador Global em Microsoft Entra ID e não há suporte para autenticação com MFA. OBSERVAÇÃO: se o DirSync tiver sido desabilitado no locatário, você precisará reabilitar temporariamente o DirSync para remover pastas públicas habilitadas para email órfãs do Microsoft Entra ID.

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsAadPublicFolders -Credential $(Get-Credential) -Path <file_name>

PARAMETERS

-Credential

Credencial de Administrador Global do Microsoft Entra

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: true
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Path

Caminho para o arquivo de saída

Type: String
Parameter Sets: (All)
Aliases:
Required: true
Position: 2
Default value: None
Accept pipeline input: false (ByPropertyName)
Accept wildcard characters: false

CommonParameters

ENTRADAS

SAÍDAS

Esse cmdlet cria o <filename> que contém todos os objetos de PublicFolder Habilitados para Email sincronizados no formato CSV.

Export-ADSyncToolsHybridAadJoinReport

SINOPSE

Gera um relatório de certificados armazenados em objetos de computador do Active Directory, especificamente, certificados emitidos pelo recurso de ingresso no Microsoft Entra híbrido.

SYNTAX

SingleObject

Export-ADSyncToolsHybridAadJoinReport [-DN] <String> [[-Filename] <String>] [<CommonParameters>]

MultipleObjects

Export-ADSyncToolsHybridAadJoinReport [-OU] <String> [[-Filename] <String>] [<CommonParameters>]

DESCRIPTION

Essa ferramenta verifica todos os certificados presentes na propriedade UserCertificate de um objeto de computador no AD e, para cada certificado não vencido presente, valida se o certificado foi emitido para o recurso de ingresso no Microsoft Entra híbrido (ou seja, o Nome da Entidade é CN={ObjectGUID}). Antes da versão 1.4, o Microsoft Entra Connect sincronizava com o Microsoft Entra qualquer computador que contivesse pelo menos um certificado, mas nas versão 1.4 e posterior do Microsoft Entra Connect, o mecanismo ADSync pode identificar certificados de junção híbrida do Microsoft Entra e fazer "cloudfilter" (excluir) o objeto de computador da sincronização com o Microsoft Entra ID, a menos que haja um certificado de junção híbrida válido do Microsoft Entra presente. Os objetos do dispositivo do Microsoft Entra que já foram sincronizados com o AD, mas que não têm um certificado de ingresso no Microsoft Entra Device ID híbrido válido serão excluídos do Microsoft Entra Connect (CloudFiltered=TRUE) pelo Azure AD Connect.

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsHybridAzureADjoinCertificateReport -DN 'CN=Computer1,OU=SYNC,DC=Fabrikam,DC=com'

EXEMPLO 2

Export-ADSyncToolsHybridAzureADjoinCertificateReport -OU 'OU=SYNC,DC=Fabrikam,DC=com' -Filename "MyHybridAzureADjoinReport.csv" -Verbose

PARAMETERS

-DN

DistinguishedName do computador

Type: String
Parameter Sets: SingleObject
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-OU

OrganizationalUnit do AD

Type: String
Parameter Sets: MultipleObjects
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Filename

Nome do arquivo CSV de saída (opcional)

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Mais informações: Noções básicas sobre o Microsoft Entra Connect 1.4.xx.x e o desaparecimento de dispositivos

Export-ADSyncToolsObjects

SINOPSE

Exportar objetos do Microsoft Entra Connectt para arquivos XML

SYNTAX

ObjectId

Export-ADSyncToolsObjects [-ObjectId] <Object> [-Source] <Object> [-ExportSerialized] [<CommonParameters>]

DistinguishedName

Export-ADSyncToolsObjects [-DistinguishedName] <Object> [-ConnectorName] <Object> [-ExportSerialized]
 [<CommonParameters>]

DESCRIPTION

Exporta objetos ADSync internos do Metaverso e objetos conectados associados de Espaços conectores

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsObjects -ObjectId '9D220D58-0700-E911-80C8-000D3A3614C0' -Source Metaverse

EXEMPLO 2

Export-ADSyncToolsObjects -ObjectId '9e220d58-0700-e911-80c8-000d3a3614c0' -Source ConnectorSpace

EXEMPLO 3

Export-ADSyncToolsObjects -DistinguishedName 'CN=User1,OU=ADSync,DC=Contoso,DC=com' -ConnectorName 'Contoso.com'

PARAMETERS

-ObjectId

ObjectId é o identificador exclusivo do objeto no respectivo espaço ou metaverso do conector

Type: Object
Parameter Sets: ObjectId
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Source

A origem é a tabela em que o objeto reside, que pode ser ConnectorSpace ou Metaverso

Type: Object
Parameter Sets: ObjectId
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-DistinguishedName

DistinguishedName é o identificador do objeto no respectivo espaço do conector

Type: Object
Parameter Sets: DistinguishedName
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ConnectorName

ConnectorName é o nome do espaço do conector em que o objeto reside

Type: Object
Parameter Sets: DistinguishedName
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ExportSerialized

ExportSerialized exporta arquivos XML adicionais

Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Export-ADSyncToolsRunHistory

SINOPSE

Exportar o histórico de execuções do Microsoft Entra Connect

SYNTAX

Export-ADSyncToolsRunHistory [-TargetName] <String> [<CommonParameters>]

DESCRIPTION

A função para exportar os resultados do perfil de execução e etapa de execução do Microsoft Entra Connect para os formatos CSV e XML, respectivamente. O arquivo CSV do perfil de execução resultante pode ser importado para uma planilha e o arquivo XML da etapa de execução pode ser importado com Import-Clixml

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsRunHistory -TargetName MyADSyncHistory

PARAMETERS

-TargetName

Nome do arquivo de saída

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Export-ADSyncToolsSourceAnchorReport

SINOPSE

Exportar o relatório ms-ds-Consistency-Guid

SYNTAX

Export-ADSyncToolsSourceAnchorReport [-AlternativeLoginId] [-UserPrincipalName] <String>
 [-ImmutableIdGUID] <String> [-Output] <String> [<CommonParameters>]

DESCRIPTION

Gera um relatório de ms-ds-Consistency-Guid com base em um arquivo CSV de importação de Import-ADSyncToolsSourceAnchor

EXEMPLOS

EXEMPLO 1

Import-Csv .\AllSyncUsers.csv | Export-ADSyncToolsSourceAnchorReport -Output ".\AllSyncUsers-Report"

EXEMPLO 2

Another example of how to use this cmdlet

PARAMETERS

-AlternativeLoginId

Use a ID de logon alternativa (email)

Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-UserPrincipalName

UserPrincipalName

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ImmutableIdGUID

ImmutableIdGUID

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Output

Nome de arquivo de saída para arquivos de log e CSV

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Get-ADSyncToolsAadObject

SINOPSE

Obter objetos sincronizados para um determinado SyncObjectType

SYNTAX

Get-ADSyncToolsAadObject [-SyncObjectType] <Object> [-Credential] <PSCredential> [<CommonParameters>]

DESCRIPTION

Lê do Microsoft Entra todos os objetos sincronizados de uma determinada classe de objeto (SyncObjectType).

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsAadObject -SyncObjectType 'publicFolder' -Credential $(Get-Credential)

PARAMETERS

-SyncObjectType

Tipo de objeto

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Credential

Credenciais de administrador global do Microsoft Entra

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

SAÍDAS

Esse cmdlet retorna as propriedades “sombra” sincronizadas pelo cliente de sincronização, que podem ser diferentes do valor real armazenado na respectiva propriedade do Microsoft Entra ID. Por exemplo, o UPN de um usuário sincronizado com um sufixo de domínio não verificado “user@nonverified.domain”, terá o sufixo UPN no Microsoft Entra ID convertido no domínio padrão do locatário, “user@tenantname.onmicrosoft.com”. Nesse caso, Get-ADSyncToolsAadObject retornará o valor "sombra" de “user@nonverified.domain” e não o valor real no Microsoft Entra ID “user@tenantname.onmicrosoft.com”.

Get-ADSyncToolsMsDsConsistencyGuid

SINOPSE

Obter ms-ds-ConsistencyGuid de objeto do AD DS

SYNTAX

Get-ADSyncToolsMsDsConsistencyGuid [-Identity] <Object> [<CommonParameters>]

DESCRIPTION

Retorna o valor do atributo mS-DS-ConsistencyGuid do objeto do Active Directory de destino no formato GUID. Permite objetos do Active Directory em florestas de vários domínios.

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsMsDsConsistencyGuid -Identity 'CN=User1,OU=Sync,DC=Contoso,DC=com'

EXEMPLO 2

Get-ADSyncToolsMsDsConsistencyGuid -Identity 'User1@Contoso.com'

EXEMPLO 3

'User1@Contoso.com' | Get-ADSyncToolsMsDsConsistencyGuid

PARAMETERS

-Identity

Objeto de destino no AD para obter

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Get-ADSyncToolsRunHistory

SINOPSE

Obter o histórico de execuções do Microsoft Entra Connect

SYNTAX

Get-ADSyncToolsRunHistory [[-Days] <Int32>] [<CommonParameters>]

DESCRIPTION

Função que retorna o histórico de execuções do Microsoft Entra Connect em formato XML

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsRunHistory

EXEMPLO 2

Get-ADSyncToolsRunHistory -Days 3

PARAMETERS

-Days

Número de dias atrás para coletar o Histórico (padrão = 1)

Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Get-ADSyncToolsRunHistoryLegacyWmi

SINOPSE

Obter o histórico de execuções do Microsoft Entra Connect para versões mais antigas do Microsoft Entra Connect (WMI)

SYNTAX

Get-ADSyncToolsRunHistoryLegacyWmi [[-Days] <Int32>] [<CommonParameters>]

DESCRIPTION

Função que retorna o histórico de execuções do Microsoft Entra Connect em formato XML

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsRunHistory

EXEMPLO 2

Get-ADSyncToolsRunHistory -Days 3

PARAMETERS

-Days

Número de dias atrás para coletar o Histórico (padrão = 1)

Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: 1
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Get-ADSyncToolsSqlBrowserInstances

SINOPSE

Obter as instâncias do SQL Server do serviço SQL Browser

SYNTAX

Get-ADSyncToolsSqlBrowserInstances [[-Server] <String>]

DESCRIPTION

Funções e utilitários relacionados a diagnóstico de SQL

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsSqlBrowserInstances -Server 'sqlserver01'

PARAMETERS

-Server

Nome do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Get-ADSyncToolsTenantAzureEnvironment

SINOPSE

Função auxiliar para obter a qual ambiente do Azure o usuário pertence.

SYNTAX

Get-ADSyncToolsTenantAzureEnvironment [-Credential] <PSCredential> [<CommonParameters>]

DESCRIPTION

Essa função chamará o ponto de extremidade de descoberta do Oauth para obter CloudInstance e tenant_region_scope determinar o ambiente do Azure. https://login.microsoftonline.com/{tenant}/.well-known/openid-configuration

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsTenantAzureEnvironment -Credential (Get-Credential)

PARAMETERS

-Credential

O objeto de credencial do PowerShell do usuário:

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

ENTRADAS

O objeto de credencial do PowerShell do usuário

SAÍDAS

O ambiente do Azure (cadeia de caracteres)

Get-ADSyncToolsTls12

SINOPSE

Obtém as configurações do TLS 1.2 de cliente/servidor para o .NET Framework

SYNTAX

Get-ADSyncToolsTls12 [<CommonParameters>]

DESCRIPTION

Lê informações do Registro sobre o TLS 1.2 para .NET Framework:

Caminho	Nome
HKLM:\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v4.0.30319	SystemDefaultTlsVersions
HKLM:\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v4.0.30319	SchUseStrongCrypto
HKLM:\SOFTWARE\Microsoft.NETFramework\v4.0.30319	SystemDefaultTlsVersions
HKLM:\SOFTWARE\Microsoft.NETFramework\v4.0.30319	SchUseStrongCrypto
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server	habilitado
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server	DisabledByDefault
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client	habilitado
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client	DisabledByDefault

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsTls12

PARAMETERS

CommonParameters

Mais informações: Aplicação do TLS 1.2 para Microsoft Entra Connect

Import-ADSyncToolsObjects

SINOPSE

Importar o objeto do Microsoft Entra Connect do arquivo XML

SYNTAX

Import-ADSyncToolsObjects [-Path] <String> [<CommonParameters>]

DESCRIPTION

Importa um objeto ADSync interno do arquivo XML que foi exportado usando Export-ADSyncToolsObjects

EXEMPLOS

EXEMPLO 1

Import-ADSyncToolsObjects -Path .\20210224-003104_81275a23-0168-eb11-80de-00155d188c11_MV.xml

PARAMETERS

-Path

Caminho para o arquivo XML a importar

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Import-ADSyncToolsRunHistory

SINOPSE

Importar o histórico de execuções do Microsoft Entra Connect

SYNTAX

Import-ADSyncToolsRunHistory [-Path] <String> [<CommonParameters>]

DESCRIPTION

Função para importar resultados da etapa de execução do Microsoft Entra Connect do XML criado usando Export-ADSyncToolsRunHistory

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsRunHistory -Path .\RunHistory-RunStep.xml

PARAMETERS

-Path

Caminho para o arquivo XML a importar

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Import-ADSyncToolsSourceAnchor

SINOPSE

Importar ImmutableID do Microsoft Entra ID

SYNTAX

Import-ADSyncToolsSourceAnchor [-Output] <String> [-IncludeSyncUsersFromRecycleBin] [<CommonParameters>]

DESCRIPTION

Gera um arquivo com todos os usuários sincronizados do Microsoft Entra ID que contém o valor ImmutableID no formato GUID. Requisitos: Módulo MSOnline do PowerShell

EXEMPLOS

EXEMPLO 1

Import-ADSyncToolsSourceAnchor -OutputFile '.\AllSyncUsers.csv'

EXEMPLO 2

Import-ADSyncToolsSourceAnchor -OutputFile '.\AllSyncUsers.csv' -IncludeSyncUsersFromRecycleBin

PARAMETERS

-Output

Arquivo CSV de saída

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IncludeSyncUsersFromRecycleBin

Obter usuários sincronizados da lixeira de Microsoft Entra ID

Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Invoke-ADSyncToolsSqlQuery

SINOPSE

Invocar uma consulta SQL em relação a um banco de dados para fins de teste

SYNTAX

Invoke-ADSyncToolsSqlQuery [-SqlConnection] <SqlConnection> [[-Query] <String>] [<CommonParameters>]

DESCRIPTION

Funções e utilitários relacionados a diagnóstico de SQL

EXEMPLOS

EXEMPLO 1

New-ADSyncToolsSqlConnection -Server SQLserver01.Contoso.com -Port 49823 | Invoke-ADSyncToolsSqlQuery

EXEMPLO 2

$sqlConn = New-ADSyncToolsSqlConnection -Server SQLserver01.Contoso.com -Port 49823
Invoke-ADSyncToolsSqlQuery -SqlConnection $sqlConn -Query 'SELECT *, database_id FROM sys.databases'

PARAMETERS

-SqlConnection

Conexão do SQL

Type: SqlConnection
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Query

Consulta SQL

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: SELECT name, database_id FROM sys.databases
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Remove-ADSyncToolsAadObject

SINOPSE

Remover objeto sincronizado órfão do Microsoft Entra ID

SYNTAX

CsvInput

Remove-ADSyncToolsAadObject [-Credential] <PSCredential> [-InputCsvFilename] <Object> [-WhatIf] [-Confirm]
 [<CommonParameters>]

ObjectInput

Remove-ADSyncToolsAadObject [-Credential] <PSCredential> [-SourceAnchor] <Object> [-SyncObjectType] <Object>
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Exclui do Microsoft Entra ID objetos sincronizados com base em SourceAnchor e ObjecType em lotes de 10 objetos. O arquivo CSV pode ser gerado usando Export-ADSyncToolsAadDisconnectors

EXEMPLOS

EXEMPLO 1

Remove-ADSyncToolsAadObject -InputCsvFilename .\DeleteObjects.csv -Credential (Get-Credential)

EXEMPLO 2

Remove-ADSyncToolsAadObject -SourceAnchor '2epFRNMCPUqhysJL3SWL1A==' -SyncObjectType 'publicFolder' -Credential (Get-Credential)

PARAMETERS

-Credential

Credenciais de administrador global do Microsoft Entra

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-InputCsvFilename

Arquivo de entrada CSV

Type: Object
Parameter Sets: CsvInput
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SourceAnchor

Objeto SourceAnchor

Type: Object
Parameter Sets: ObjectInput
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-SyncObjectType

Tipo de objeto

Type: Object
Parameter Sets: ObjectInput
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

ENTRADAS

InputCsvFilename precisa apontar para um arquivo CSV com pelo menos duas colunas: SourceAnchor, SyncObjectType

SAÍDAS

Mostra os resultados da operação ExportDeletions. AVISO DE ISENÇÃO DE RESPONSABILIDADE: além de objetos do usuário que têm uma lixeira, qualquer outro tipo de objeto EXCLUÍDO com essa função não poderá ser RECUPERADO!

Remove-ADSyncToolsAadPublicFolders

SINOPSE

Remove Pastas Públicas Habilitadas para Email (MEPF) sincronizadas presentes do Microsoft Entra ID. Você pode especificar um SourceAnchor/ImmutableID para o objeto MEPF de destino a ser excluído ou fornecer uma lista CSV com um lote de objetos a serem excluídos quando usados em conjunto com Export-ADSyncToolsAadPublicFolders. Essa função requer as credenciais de um Administrador Global em Microsoft Entra ID e não há suporte para autenticação com MFA. OBSERVAÇÃO: se o DirSync tiver sido desabilitado no locatário, você precisará reabilitar temporariamente o DirSync para remover pastas públicas habilitadas para email órfãs do Microsoft Entra ID.

SYNTAX

Export-ADSyncToolsAadPublicFolders [-Credential] <PSCredential> [-Path] <Object> [<CommonParameters>]

DESCRIPTION

EXEMPLOS

EXEMPLO 1

Remove-ADSyncToolsAadPublicFolders [-Credential] <PSCredential> [-InputCsvFilename] <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

EXEMPLO 2

Remove-ADSyncToolsAadPublicFolders [-Credential] <PSCredential> [-SourceAnchor] <Object> [-WhatIf] [-Confirm] [<CommonParameters>]

PARAMETERS

-Credential

Credencial de Administrador Global do Microsoft Entra

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: true
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-InputCsvFilename

Caminho para o arquivo CSV de entrada

Type: String
Parameter Sets: InputCsv
Aliases:
Required: true
Position: 2
Default value: None
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

-SourceAnchor

SourceAnchor/ImmutableID de destino

Type: String
Parameter Sets: SourceAnchor
Aliases:
Required: true
Position: 2
Default value: None
Accept pipeline input: true (ByPropertyName)
Accept wildcard characters: false

CommonParameters

ENTRADAS

O arquivo de entrada CSV pode ser gerado usando Export-ADSyncToolsAadPublicFolders. Os parâmetros de caminho devem apontar para um arquivo CSV com pelo menos duas colunas: SourceAnchor, SyncObjectType.

SAÍDAS

Mostra os resultados da operação ExportDeletions.

Remove-ADSyncToolsExpiredCertificates

SINOPSE

Script para remover certificados expirados do atributo UserCertificate

SYNTAX

Remove-ADSyncToolsExpiredCertificates [-TargetOU] <String> [[-BackupOnly] <Boolean>] [-ObjectClass] <String>
 [<CommonParameters>]

DESCRIPTION

Esse script usa todos os objetos de uma unidade organizacional de destino no domínio do Active Directory – filtrados por classe de objeto (usuário/computador) – e exclui todos os certificados expirados presentes no atributo UserCertificate. Por padrão, (modo BackupOnly) ele fará backup apenas de certificados expirados para um arquivo e não fará nenhuma alteração no AD. Se você usa -BackupOnly $false, então qualquer certificado vencido presente no atributo UserCertificate para esses objetos é removido do Active Directory depois de ser copiado para o arquivo. Cada certificado será feito para um nome do arquivo separado: ObjectClass_ObjectGUID_CertThumprint.cer. O script também criará um arquivo de log no formato CSV mostrando todos os usuários com certificados que são válidos ou expirados, incluindo a ação real tomada ( Ignorado/Exportado/Excluído).

EXEMPLOS

EXEMPLO 1

Verificar todos os usuários na UO de destino – Certificados Expirados serão copiados para arquivos separados e nenhum certificado será removido

Remove-ADSyncToolsExpiredCertificates -TargetOU "OU=Users,OU=Corp,DC=Contoso,DC=com" -ObjectClass user

EXEMPLO 2

Excluir Certificados Expirados de todos os objetos do computador na UO de destino – Certificados Expirados serão copiados para arquivos e removidos do AD

Remove-ADSyncToolsExpiredCertificates -TargetOU "OU=Computers,OU=Corp,DC=Contoso,DC=com" -ObjectClass computer -BackupOnly $false

PARAMETERS

-TargetOU

UO de destino para pesquisar por objetos do AD

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-BackupOnly

BackupOnly não excluirá nenhum certificado do AD

Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: True
Accept pipeline input: False
Accept wildcard characters: False

-ObjectClass

Filtro de classe de objeto

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Repair-ADSyncToolsAutoUpgradeState

SINOPSE

Reparar o estado AutoUpgrade do Microsoft Entra Connect

SYNTAX

Repair-ADSyncToolsAutoUpgradeState

DESCRIPTION

Corrige um problema com AutoUpgrade introduzido no build 1.1.524 (maio de 2017), que desabilita a verificação online de novas versões enquanto o AutoUpgrade está habilitado.

EXEMPLOS

EXEMPLO 1

Repair-ADSyncToolsAutoUpgradeState

Resolve-ADSyncToolsSqlHostAddress

SINOPSE

Resolver um nome do servidor do SQL

SYNTAX

Resolve-ADSyncToolsSqlHostAddress [-Server] <String> [<CommonParameters>]

DESCRIPTION

Funções e utilitários relacionados a diagnóstico de SQL

EXEMPLOS

EXEMPLO 1

Resolve-ADSyncToolsSqlHostAddress -Server 'sqlserver01'

PARAMETERS

-Server

Nome do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Search-ADSyncToolsADobject

SINOPSE

Pesquisar um objeto do Active Directory na floresta do Active Directory por seu UserPrincipalName, sAMAccountName ou DistinguishedName

SYNTAX

Search-ADSyncToolsADobject [-Identity] <Object> [<CommonParameters>]

DESCRIPTION

Permite consultas em vários domínios e retorna todas as propriedades necessárias, incluindo mS-DS-ConsistencyGuid.

EXEMPLOS

EXEMPLO 1

Search-ADSyncToolsADobject 'CN=user1,OU=Sync,DC=Contoso,DC=com'

EXEMPLO 2

Search-ADSyncToolsADobject -Identity "user1@Contoso.com"

EXEMPLO 3

Get-ADUser 'CN=user1,OU=Sync,DC=Contoso,DC=com' | Search-ADSyncToolsADobject

PARAMETERS

-Identity

Usuário de destino no Active Directory para definir ConsistencyGuid

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Set-ADSyncToolsMsDsConsistencyGuid

SINOPSE

Definir o ms-ds-ConsistencyGuid de um objeto do Active Directory

SYNTAX

Set-ADSyncToolsMsDsConsistencyGuid [-Identity] <Object> [-Value] <Object> [<CommonParameters>]

DESCRIPTION

Define um valor no atributo mS-Ds-ConsistencyGuid do usuário de destino do Active Directory. Permite objetos do Active Directory em florestas de vários domínios.

EXEMPLOS

EXEMPLO 1

Set-ADSyncToolsMsDsConsistencyGuid -Identity 'CN=User1,OU=Sync,DC=Contoso,DC=com' -Value '88666888-0101-1111-bbbb-1234567890ab'

EXEMPLO 2

Set-ADSyncToolsMsDsConsistencyGuid -Identity 'CN=User1,OU=Sync,DC=Contoso,DC=com' -Value 'GGhsjYwBEU+buBsE4sqhtg=='

EXEMPLO 3

Set-ADSyncToolsMsDsConsistencyGuid 'User1@Contoso.com' '8d6c6818-018c-4f11-9bb8-1b04e2caa1b6'

EXEMPLO 4

Set-ADSyncToolsMsDsConsistencyGuid 'User1@Contoso.com' 'GGhsjYwBEU+buBsE4sqhtg=='

EXEMPLO 5

'88666888-0101-1111-bbbb-1234567890ab' | Set-ADSyncToolsMsDsConsistencyGuid -Identity User1

EXEMPLO 6

'GGhsjYwBEU+buBsE4sqhtg==' | Set-ADSyncToolsMsDsConsistencyGuid User1

PARAMETERS

-Identity

Objeto de destino no AD para definir mS-DS-ConsistencyGuid

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Value

Valor a definir (ImmutableId, matriz de bytes, GUID, cadeia de caracteres do GUID ou cadeia de caracteres Base64)

Type: Object
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Set-ADSyncToolsTls12

SINOPSE

Define as configurações do TLS 1.2 de cliente/servidor para o .NET Framework

SYNTAX

Set-ADSyncToolsTls12 [[-Enabled] <Boolean>] [<CommonParameters>]

DESCRIPTION

Define as entradas do registro para habilitar/desabilitar o TLS 1.2 para .NET Framework:

Caminho	Nome
HKLM:\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v4.0.30319	SystemDefaultTlsVersions
HKLM:\SOFTWARE\WOW6432Node\Microsoft.NETFramework\v4.0.30319	SchUseStrongCrypto
HKLM:\SOFTWARE\Microsoft.NETFramework\v4.0.30319	SystemDefaultTlsVersions
HKLM:\SOFTWARE\Microsoft.NETFramework\v4.0.30319	SchUseStrongCrypto
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server	habilitado
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server	DisabledByDefault
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client	habilitado
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client	DisabledByDefault

Executar o cmdlet sem parâmetros habilita o TLS 1.2 para .NET Framework

EXEMPLOS

EXEMPLO 1

Set-ADSyncToolsTls12

EXEMPLO 2

Set-ADSyncToolsTls12 -Enabled $true

PARAMETERS

-Enabled

TLS 1.2 habilitado

Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: True
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

CommonParameters

Mais informações: Aplicação do TLS 1.2 para Microsoft Entra Connect

Test-ADSyncToolsSqlNetworkPort

SINOPSE

Testar a porta de rede do SQL Server

SYNTAX

Test-ADSyncToolsSqlNetworkPort [[-Server] <String>] [[-Port] <String>]

DESCRIPTION

Funções e utilitários relacionados a diagnóstico de SQL

EXEMPLOS

EXEMPLO 1

Test-ADSyncToolsSqlNetworkPort -Server 'sqlserver01'

EXEMPLO 2

Test-ADSyncToolsSqlNetworkPort -Server 'sqlserver01' -Port 1433

PARAMETERS

-Server

Nome do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Port

Porta do SQL Server

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Trace-ADSyncToolsADImport

SINOPSE

Cria um arquivo de rastreamento de uma etapa de importação do Active Directory

SYNTAX

ADConnectorXML

Trace-ADSyncToolsADImport [-DC] <String> [-RootDN] <String> [[-Filter] <String>] [[-Credential] <PSCredential>]
 [-SSL] [-ADConnectorXML] <String> [<CommonParameters>]

ADwatermarkInput

Trace-ADSyncToolsADImport [-DC] <String> [-RootDN] <String> [[-Filter] <String>] [[-Credential] <PSCredential>]
 [-SSL] [-ADwatermark] <String> [<CommonParameters>]

DESCRIPTION

Rastreamentos de todas as consultas LDAP de uma importação do Active Directory são executados de um determinado ponto de verificação de marca-d'água do Active Directory (também chamado de cookie de partição). Cria um arquivo de rastreamento '.\ADimportTrace_yyyyMMddHHmmss.log' na pasta atual. Para usar o -ADConnectorXML, vá para o Synchronization Service Manager, clique com o botão direito do mouse no Conector do AD e escolha "Exportar Conector..."

EXEMPLOS

EXEMPLO 1

Rastrear a Importação do Active Directory para objetos de usuário fornecendo um arquivo XML do Conector do AD

Trace-ADSyncToolsADImport -DC 'DC1.contoso.com' -RootDN 'DC=Contoso,DC=com' -Filter '(&(objectClass=user))' -ADConnectorXML .\ADConnector.xml

EXEMPLO 2

Rastrear a Importação do Active Directory para todos os objetos fornecendo a marca d'água do Active Directory (cookie) e a credencial do Conector do AD

$creds = Get-Credential
Trace-ADSyncToolsADImport -DC 'DC1.contoso.com' -RootDN 'DC=Contoso,DC=com' -Credential $creds -ADwatermark "TVNEUwMAAAAXyK9ir1zSAQAAAAAAAAAA(...)"

PARAMETERS

-DC

Controlador de domínio de destino

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RootDN

DN de raiz de floresta

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Filter

Tipo de objetos do AD a rastrear. Use “(&(objectClass=*))” para todos os tipos de objeto

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: (&(objectClass=*))
Accept pipeline input: False
Accept wildcard characters: False

-Credential

Informe a credencial para executar a consulta LDAP no AD

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: False
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SSL

Conexão SSL

Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-ADConnectorXML

Arquivo XML de exportação do Conector do AD – clique com o botão direito do mouse no Conector do AD e escolha "Exportar Conector..."

Type: String
Parameter Sets: ADConnectorXML
Aliases:
Required: True
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ADwatermark

Entrada manual de marca d'água, em vez de arquivo XML, por exemplo $ ADwatermark = "TVNEUwMAAAAXyK9ir1zSAQAAAAAAAAAA (...)"

Type: String
Parameter Sets: ADwatermarkInput
Aliases:
Required: True
Position: 6
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Trace-ADSyncToolsLdapQuery

SINOPSE

Rastrear consultas LDAP

SYNTAX

Trace-ADSyncToolsLdapQuery [-RootDN] <String> [-Credential] <PSCredential> [[-Server] <String>]
 [[-Port] <Int32>] [-Filter <String>] [<CommonParameters>]

DESCRIPTION

EXEMPLOS

EXEMPLO 1

Trace-ADSyncToolsLdapQuery -RootDN "DC=Contoso,DC=com" -Credential $Credential

PARAMETERS

-RootDN

DistinguishedName da floresta/domínio

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Credential

Credencial do AD

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Server

Nome do controlador de domínio (opcional)

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Port

Porta do controlador de domínio (padrão: 389)

Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: 389
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Filter

Filtro LDAP (padrão: objectClass=*)

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: (objectClass=*)
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Update-ADSyncToolsSourceAnchor

SINOPSE

Atualiza os usuários com o novo ConsistencyGuid (ImmutableId)

SYNTAX

Update-ADSyncToolsSourceAnchor [[-DistinguishedName] <String>] [-ImmutableIdGUID] <String> [-Action] <String>
 [-Output] <String> [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Atualiza os usuários com o novo valor de ConsistencyGuid (ImmutableId) obtido do relatório de ConsistencyGuid. Essa função é compatível com a opção WhatIf. Observação: o relatório ConsistencyGuid precisa ser importado com delimitador de tabulação

EXEMPLOS

EXEMPLO 1

Import-Csv .\AllSyncUsers-Report.csv -Delimiter "`t"| Update-ADSyncToolsSourceAnchor -Output .\AllSyncUsersTEST-Result2 -WhatIf

EXEMPLO 2

Import-Csv .\AllSyncUsers-Report.csv -Delimiter "`t"| Update-ADSyncToolsSourceAnchor -Output .\AllSyncUsersTEST-Result2

PARAMETERS

-DistinguishedName

DistinguishedName

Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: False
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-ImmutableIdGUID

ImmutableIdGUID

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Action

Ação

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-Output

Nome de arquivo de saída para arquivos de log

Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Get-ADSyncToolsDuplicateUsersSourceAnchor

SINOPSE

Obtém uma lista de todos os objetos com o erro "A âncora de origem mudou".

SYNTAX

Get-ADSyncToolsDuplicateUsersSourceAnchor [-ADConnectorName] <Object> [<CommonParameters>]

DESCRIPTION

Há determinados cenários, como M&A, em que os clientes adicionam uma nova floresta para o Microsoft Entra Connect com objetos de usuário duplicados. Isso causará vários erros de sincronização se a nova precedência do conector for maior para os usuários recém-ingressados. Esse cmdlet fornecerá uma lista de todos os objetos com erros "A âncora de origem mudou".

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsDuplicateUsersSourceAnchor -ADConnectorName Contoso.com

PARAMETERS

-ADConnectorName

Nome do conector do AD para o qual as âncoras de origem do usuário precisam ser reparadas

Type: Object
Parameter Sets: (All)
Aliases:
Required: true
Position: 1
Default value: 
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

CommonParameters

Set-ADSyncToolsDuplicateUsersSourceAnchor

SINOPSE

Corrige todos os objetos com o erro "A âncora de origem mudou".

SYNTAX

et-ADSyncToolsDuplicateUsersSourceAnchor [-DuplicateUserSourceAnchorInfo] <DuplicateUserSourceAnchorInfo> [-ActiveDirectoryCredential <PSCredential>] [-OverridePrompt <Boolean>] [<CommonParameters>]

DESCRIPTION

Esse cmdlet usa a lista de objetos de Get-ADSyncToolsDuplicateUsersSourceAnchor como entrada de pipeline. Em seguida, ele corrige os erros de sincronização atualizando o atributo msDS-ConsistencyGuid com o sourceAnchor/immutableID do objeto original. O cmdlet tem um parâmetro opcional – "Override prompt", que é False por padrão. Se ele estiver definido como True, o usuário não verá nenhum prompt ao atualizar o atributo msDS-ConsistencyGuid.

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsDuplicateUsersSourceAnchor -ADConnectorName Contoso.lab | Set-ADSyncToolsDuplicateUsersSourceAnchor

EXEMPLO 2

Get-ADSyncToolsDuplicateUsersSourceAnchor -ADConnectorName Contoso.lab | Set-ADSyncToolsDuplicateUsersSourceAnchor -OverridePrompt $true

PARAMETERS

-DuplicateUserSourceAnchorInfo

Lista de usuários para a qual a âncora de origem precisa ser corrigida

Type: DuplicateUserSourceAnchorInfo
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: 
Accept pipeline input: True (ByValue, ByPropertyName)
Accept wildcard characters: False

-ActiveDirectoryCredential

Credenciais de Administração do AD EA/DA. Se não forem fornecidas, as credenciais padrão serão usadas

Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 
Accept pipeline input: False
Accept wildcard characters: False

-OverridePrompt

Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Share via

Microsoft Entra Connect: Referência do PowerShell do ADSyncTools

Instalar o módulo do PowerShell do ADSyncTools

Clear-ADSyncToolsMsDsConsistencyGuid

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARAMETERS

-Identity

CommonParameters

Connect-ADSyncToolsSqlDatabase

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Server

-Instance

-Database

-Port

-UserName

-Password

CommonParameters

ConvertFrom-ADSyncToolsAadDistinguishedName

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

PARAMETERS

-DistinguishedName

CommonParameters

ConvertFrom-ADSyncToolsImmutableID

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Value

CommonParameters

ConvertTo-ADSyncToolsAadDistinguishedName

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

PARAMETERS

-ImmutableId

CommonParameters

ConvertTo-ADSyncToolsCloudAnchor

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Anchor

CommonParameters

ConvertTo-ADSyncToolsImmutableID

SINOPSE

SYNTAX

DESCRIPTION

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARAMETERS

-Value

CommonParameters

Export-ADSyncToolsAadDisconnectors

SINOPSE

SYNTAX