Microsoft Entra Connect: Referência do PowerShell do ADSyncTools

Artigo
10/14/2024

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:

Abra o Windows PowerShell com privilégios administrativos

Digite ou copie e cole o seguinte:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Install-Module -Name 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 Active Directory

SINTAXE

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

DESCRIÇÃO

Limpa o valor em mS-DS-ConsistencyGuid do objeto de destino do Active Directory. 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

PARÂMETROS

-Identidade

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

SINTAXE

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

DESCRIÇÃO

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'

PARÂMETROS

-Servidor

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

-Instância

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

-Banco de dados

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

-Porta

Porta do SQL Server (por exemplo, 49823)

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

-Nome de usuário

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

-Senha

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

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

ConvertFrom-ADSyncToolsAadDistinguishedName 'CN={514635484D4B376E38307176645973555049486139513D3D}'

PARÂMETROS

-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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Valor

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 Microsoft Entra Connector

SINTAXE

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

DESCRIÇÃO

Usa um ImmutableId (SourceAnchor) como QF5HMK7n80qvdYsUPIHa9Q== e converte para o respectivo valor DistinguishedName do Microsoft Entra Connector, como CN={514635484D4B376E38307176645973555049486139513D3D}

EXEMPLOS

EXEMPLO 1

ConvertTo-ADSyncToolsAadDistinguishedName 'QF5HMK7n80qvdYsUPIHa9Q=='

PARÂMETROS

-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 a âncora Base64 para CloudAnchor

SINTAXE

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

DESCRIÇÃO

Usa uma âncora Base64 como VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA== e converte para o respectivo valor CloudAnchor, por exemplo, User_00aa00aa-bb11-cc22-dd33-44ee44ee44ee

EXEMPLOS

EXEMPLO 1

ConvertTo-ADSyncToolsCloudAnchor "VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA=="

EXEMPLO 2

"VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA==" | ConvertTo-ADSyncToolsCloudAnchor

PARÂMETROS

-Âncora

Â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

SINTAXE

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

DESCRIÇÃO

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 '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

EXEMPLO 2

'00aa00aa-bb11-cc22-dd33-44ee44ee44ee' | ConvertTo-ADSyncToolsImmutableID

PARÂMETROS

-Valor

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

SINTAXE

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

DESCRIÇÃO

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 PublicFolder Disconnector

EXEMPLO 2

Export-ADSyncToolsAadDisconnectors

Exporta para CSV todos os objetos do Disconnector

PARÂMETROS

-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 Desconectadores que contêm: UserPrincipalName, Mail, SourceAnchor, DistinguishedName, CsObjectId, ObjectType, ConnectorId e CloudAnchor

Export-ADSyncToolsAadPublicFolders

SINOPSE

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

SINTAXE

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

DESCRIÇÃO

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, será necessário 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>

PARÂMETROS

-Credencial

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

-Caminho

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.

SINTAXE

SingleObject

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

MultipleObjects

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

DESCRIÇÃO

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 posteriores 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 Microsoft Entra 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

PARÂMETROS

-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: Entenda 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

SINTAXE

ObjectId

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

DistinguishedName

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

Export-ADSyncToolsObjects -ObjectId 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb' -Source Metaverse

EXEMPLO 2

Export-ADSyncToolsObjects -ObjectId 'bbbbbbbb-1111-2222-3333-cccccccccccc' -Source ConnectorSpace

EXEMPLO 3

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

PARÂMETROS

-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

-Origem

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

SINTAXE

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

DESCRIÇÃO

Função de 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

PARÂMETROS

-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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-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

SINTAXE

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

DESCRIÇÃO

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)

PARÂMETROS

-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

-Credencial

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 Active Directory

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Identidade

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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Dias

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)

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Dias

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

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

Get-ADSyncToolsSqlBrowserInstances -Server 'sqlserver01'

PARÂMETROS

-Servidor

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 definir a qual ambiente do Azure o usuário pertence.

SINTAXE

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

DESCRIÇÃO

Essa função chamará o ponto de extremidade de descoberta do Oauth para obter o CloudInstance e para o 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)

PARÂMETROS

-Credencial

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 (sequência)

Get-ADSyncToolsTls12

SINOPSE

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

SINTAXE

Get-ADSyncToolsTls12 [<CommonParameters>]

DESCRIÇÃO

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

PARÂMETROS

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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Caminho

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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Caminho

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

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARÂMETROS

-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

SINTAXE

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

DESCRIÇÃO

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'

PARÂMETROS

-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

SINTAXE

CsvInput

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

ObjectInput

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

DESCRIÇÃO

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)

PARÂMETROS

-Credencial

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

Nome do 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) atuais sincronizadas do Microsoft Entra ID. É possível 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 órfãs habilitadas para email do Microsoft Entra ID.

SINTAXE

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

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

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

EXEMPLO 2

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

PARÂMETROS

-Credencial

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

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

SINTAXE

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

DESCRIÇÃO

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) fará backup apenas de certificados expirados para um arquivo e não fará nenhuma alteração no AD. Caso -BackupOnly $false seja utilizado, então qualquer Certificado Expirado presente no atributo UserCertificate desses objetos será removido do Active Directory após ser copiado para o arquivo. O backup dos certificados será feito em um nome de arquivo separado: ObjectClass_ObjectGUID_CertThumprint.cer. O script também criará um arquivo de registro em formato CSV mostrando todos os usuários com certificados 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 OU 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

PARÂMETROS

-TargetOU

OU 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

SINTAXE

Repair-ADSyncToolsAutoUpgradeState

DESCRIÇÃO

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

SINTAXE

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

DESCRIÇÃO

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

EXEMPLOS

EXEMPLO 1

Resolve-ADSyncToolsSqlHostAddress -Server 'sqlserver01'

PARÂMETROS

-Servidor

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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Identidade

Usuário de destino no AD para definir o 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

SINTAXE

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

DESCRIÇÃO

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 '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

EXEMPLO 2

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

EXEMPLO 3

Set-ADSyncToolsMsDsConsistencyGuid 'User1@Contoso.com' '11bb11bb-cc22-dd33-ee44-55ff55ff55ff'

EXEMPLO 4

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

EXEMPLO 5

'00aa00aa-bb11-cc22-dd33-44ee44ee44ee' | Set-ADSyncToolsMsDsConsistencyGuid -Identity User1

EXEMPLO 6

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

PARÂMETROS

-Identidade

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

-Valor

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

SINTAXE

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

DESCRIÇÃO

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 habilitará o TLS 1.2 para .NET Framework

EXEMPLOS

EXEMPLO 1

Set-ADSyncToolsTls12

EXEMPLO 2

Set-ADSyncToolsTls12 -Enabled $true

PARÂMETROS

-Habilitado

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

SINTAXE

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

DESCRIÇÃO

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

PARÂMETROS

-Servidor

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

-Porta

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

SINTAXE

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>]

DESCRIÇÃO

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(...)"

PARÂMETROS

-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

-Credencial

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

SINTAXE

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

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

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

PARÂMETROS

-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

-Credencial

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

-Servidor

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

-Porta

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)

SINTAXE

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

DESCRIÇÃO

Atualiza os usuários com o novo valor ConsistencyGuid (ImmutableId) obtido do Relatório ConsistencyGuid. Essa função dá suporte ao switch -WhatIf.

Observação: o relatório ConsistencyGuid deve ser importado com o delimitador de guias.

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

PARÂMETROS

-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

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".

SINTAXE

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

DESCRIÇÃO

Há determinados cenários, como M&A, em que os clientes adicionam uma nova floresta ao 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

PARÂMETROS

-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".

SINTAXE

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

DESCRIÇÃO

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 é falso por padrão. Se ele estiver definido como verdadeiro, 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

PARÂMETROS

-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

Compartilhar via

Microsoft Entra Connect: Referência do PowerShell do ADSyncTools

Instalar o módulo do PowerShell do ADSyncTools

Clear-ADSyncToolsMsDsConsistencyGuid

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

EXEMPLO 3

PARÂMETROS

-Identidade

CommonParameters

Connect-ADSyncToolsSqlDatabase

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Servidor

-Instância

-Banco de dados

-Porta

-Nome de usuário

-Senha

CommonParameters

ConvertFrom-ADSyncToolsAadDistinguishedName

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

PARÂMETROS

-DistinguishedName

CommonParameters

ConvertFrom-ADSyncToolsImmutableID

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Valor

CommonParameters

ConvertTo-ADSyncToolsAadDistinguishedName

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

PARÂMETROS

-ImmutableId

CommonParameters

ConvertTo-ADSyncToolsCloudAnchor

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Âncora

CommonParameters

ConvertTo-ADSyncToolsImmutableID

SINOPSE

SINTAXE

DESCRIÇÃO

EXEMPLOS

EXEMPLO 1

EXEMPLO 2

PARÂMETROS

-Valor

CommonParameters

Export-ADSyncToolsAadDisconnectors

SINOPSE

SINTAXE