共用方式為


Microsoft Entra Connect:ADSyncTools PowerShell 參考

下列文件提供 Microsoft Entra Connect 隨附的 ADSyncTools.psm1 PowerShell 模組的參考資訊。

安裝 ADSyncTools PowerShell 模組

若要安裝 ADSyncTools PowerShell 模組,請執行下列動作:

  1. 使用系統管理權限來開啟 Windows PowerShell
  2. 輸入或複製並貼上下列內容:
        [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"
    
  3. 按 Enter 鍵。
  4. 若要確認已安裝模組,請輸入或複製並貼上下列內容:
    Get-module AdSyncTools
    
  5. 您現在應該會看到模組的相關資訊。

Clear-ADSyncToolsMsDsConsistencyGuid

概要

清除 Active Directory 物件 mS-DS-ConsistencyGuid

SYNTAX

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

描述

清除目標 Active Directory 物件 mS-DS-ConsistencyGuid 中的值。 支援在多網域樹系中 Active Directory 物件。

範例

範例 1

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

範例 2

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

範例 3

'User1@Contoso.com' | Clear-ADSyncToolsMsDsConsistencyGuid

PARAMETERS

-身分識別

AD 中要清除 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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Connect-ADSyncToolsSqlDatabase

概要

連線至 SQL 資料庫以進行測試

SYNTAX

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

描述

SQL 診斷相關功能和公用程式

範例

範例 1

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

範例 2

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

PARAMETERS

伺服器-

SQL Server 名稱

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

-Instance

SQL Server 執行個體名稱

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

-Database

SQL Server 資料庫名稱

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

-Port

SQL Server 連接埠 (例如,49823)

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

-UserName

SQL Server 登入使用者名稱

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

-Password

SQL Server 登入密碼

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

ConvertFrom-ADSyncToolsAadDistinguishedName

概要

將 Microsoft Entra 連接器 DistinguishedName 轉換成 ImmutableId

SYNTAX

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

描述

採用 Microsoft Entra 連接器 DistinguishedName (例如 CN={514635484D4B376E38307176645973555049486139513D3D}),並將其轉換為個別的 base64 ImmutableID 值,例如 QF5HMK7n80qvdYsUPIHa9Q==

範例

範例 1

ConvertFrom-ADSyncToolsAadDistinguishedName 'CN={514635484D4B376E38307176645973555049486139513D3D}'

PARAMETERS

-DistinguishedName

Microsoft Entra 連接器空間 DistinguishedName

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

ConvertFrom-ADSyncToolsImmutableID

概要

將 Base64 ImmutableId (SourceAnchor) 轉換成 GUID 值

SYNTAX

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

描述

轉換 Base64 字串的 ImmutableID 值,並傳回 GUID 值,若 Base64 字串無法轉換成 GUID,則會傳回位元組陣列。

範例

範例 1

ConvertFrom-ADSyncToolsImmutableID 'iGhmiAEBERG7uxI0VniQqw=='

範例 2

'iGhmiAEBERG7uxI0VniQqw==' | ConvertFrom-ADSyncToolsImmutableID

PARAMETERS

-Value

Base64 格式的 ImmutableId

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

ConvertTo-ADSyncToolsAadDistinguishedName

概要

將 ImmutableId 轉換為 Microsoft Entra Connector DistinguishedName

SYNTAX

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

描述

取得 ImmutableId (SourceAnchor),例如 QF5HMK7n80qvdYsUPIHa9Q==,並轉換為個別的 Microsoft Entra 連接器 DistinguishedName 值,例如 CN={514635484D4B376E38307176645973555049486139513D3D}

範例

範例 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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

ConvertTo-ADSyncToolsCloudAnchor

概要

將 Base64 錨點轉換成 CloudAnchor

SYNTAX

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

描述

取得 Base64 錨點,例如 VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA==,並轉換成個別的 CloudAnchor 值,例如 User_00aa00aa-bb11-cc22-dd33-44ee44ee44ee

範例

範例 1

ConvertTo-ADSyncToolsCloudAnchor "VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA=="

範例 2

"VAAAAFUAcwBlAHIAXwBjADcAMgA5ADAAMwBlAGQALQA3ADgAMQA2AC0ANAAxAGMAZAAtADkAMAA2ADYALQBlAGEAYwAzADMAZAAxADcAMQBkADcANwAAAA==" | ConvertTo-ADSyncToolsCloudAnchor

PARAMETERS

-Anchor

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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

ConvertTo-ADSyncToolsImmutableID

概要

將 GUID (ObjectGUID/ms-Ds-Consistency-Guid) 轉換為 Base64 字串

SYNTAX

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

描述

將 GUID、GUID 字串或位元組陣列格式的值轉換為 Base64 字串

範例

範例 1

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

範例 2

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

PARAMETERS

-Value

GUID、GUID 字串或位元組陣列

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Export-ADSyncToolsAadDisconnectors

概要

匯出 Microsoft Entra Disconnector 物件

SYNTAX

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

描述

執行 CSExport 工具,將所有 Disconnector 匯出至 XML,然後採用此 XML 輸出並將其轉換為 CSV 檔案,其中包括:UserPrincipalName、Mail、SourceAnchor、DistinguishedName、CsObjectId、ObjectType、ConnectorId、CloudAnchor

範例

範例 1

Export-ADSyncToolsAadDisconnectors -SyncObjectType 'PublicFolder'

將所有 PublicFolder Disconnector 物件匯出為 CSV

範例 2

Export-ADSyncToolsAadDisconnectors

將所有 Disconnector 物件匯出為 CSV

PARAMETERS

-SyncObjectType

要包含在輸出中的 ObjectType

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

如果您只想要匯出指定物件類型的 Disconnectors,請使用 ObjectType 引數

輸出

匯出包含 Disconnector 物件的 CSV 檔案,其中包含:UserPrincipalName、Mail、SourceAnchor、DistinguishedName、CsObjectId、ObjectType、ConnectorId 和 CloudAnchor

Export-ADSyncToolsAadPublicFolders

概要

將所有同步處理之擁有郵件功能的公用資料夾物件從 Microsoft Entra ID 匯出為 CSV 檔案

SYNTAX

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

描述

此函式可將 Microsoft Entra ID 中所有同步處理之擁有郵件功能的公用資料夾 (MEPF) 匯出為 CSV 檔案。 其可與 Remove-ADSyncToolsAadPublicFolders 結合使用,以識別和移除 Microsoft Entra ID 中孤立擁有郵件功能的公用資料夾。 此函式需要 Microsoft Entra ID 中全域管理員的認證,不支援使用 MFA 進行驗證。 注意:如果已在租用戶上停用 DirSync,則您必須暫時重新啟用 DirSync,才能從 Microsoft Entra ID 中移除孤立擁有郵件功能的公用資料夾。

範例

範例 1

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

PARAMETERS

-Credential

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

輸出檔案的路徑

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

輸出

此 Cmdlet 會以 CSV 格式建立包含所有已同步擁有郵件功能的公用資料夾物件之 <filename>

Export-ADSyncToolsHybridAadJoinReport

概要

針對儲存在 Active Directory 電腦物件中的憑證產生報表,特別是混合式 Microsoft Entra 混合式聯結功能所發行的憑證。

SYNTAX

SingleObject

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

MultipleObjects

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

描述

此工具會檢查 AD 中電腦物件的 UserCertificate 屬性中是否有所有憑證,並且針對每個未過期的憑證,驗證是否已針對 Microsoft Entra 混合式聯結功能發出憑證 (即主體名稱為 CN={ObjectGUID})。 在 1.4 版之前,Microsoft Entra Connect 會將 Microsoft Entra 同步到至少包含一個憑證的任何電腦,但在 Microsoft Entra Connect 1.4 版和更新版本中,ADSync 引擎可以識別 Microsoft Entra 混合式聯結憑證並「雲端篩選」(排除) 將電腦物件同步至 Microsoft Entra ID,除非存在有效的 Microsoft Entra混合式聯結憑證。 已同步至 AD 但沒有有效 Microsoft Entra 混合式聯結憑證的 Microsoft Entra 裝置物件,將會由 Microsoft Entra Connect 從 Microsoft Entra ID 刪除 (CloudFiltered = TRUE)。

範例

範例 1

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

範例 2

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

PARAMETERS

-DN

電腦 DistinguishedName

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

-OU

AD OrganizationalUnit

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

-Filename

輸出 CSV 檔案名 (選用)

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

詳細資訊:了解 Microsoft Entra Connect 1.4. x 和裝置消失 (部分機器翻譯)

Export-ADSyncToolsObjects

概要

將 Microsoft Entra Connect 物件匯出為 XML 檔案

SYNTAX

ObjectId

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

DistinguishedName

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

描述

匯出 Metaverse 的內部 ADSync 物件,以及連接器空間的相關連線物件

範例

範例 1

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

範例 2

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

範例 3

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

PARAMETERS

-ObjectId

ObjectId 是個別連接器空間或 Metaverse 中物件的唯一識別碼

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

-Source

來源是物件所在的資料表,包括 ConnectorSpace 或 Metaverse

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

-DistinguishedName

DistinguishedName 是個別連接器空間中物件的識別碼

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

-ConnectorName

ConnectorName 是物件所在的連接器空間名稱

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

-ExportSerialized

ExportSerialized 會匯出其他 XML 檔案

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Export-ADSyncToolsRunHistory

概要

匯出 Microsoft Entra Connect 執行歷程記錄

SYNTAX

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

描述

匯出 Microsoft Entra Connect 執行設定檔的函式,並執行步驟結果分別為 CSV 和 XML 格式。 產生的執行設定檔 CSV 檔案可以匯入試算表,而且可以透過 Import-Clixml 匯入執行步驟 XML 檔案

範例

範例 1

Export-ADSyncToolsRunHistory -TargetName MyADSyncHistory

PARAMETERS

-TargetName

輸出檔案的名稱

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Export-ADSyncToolsSourceAnchorReport

概要

匯出 ms-ds-Consistency-Guid 報表

SYNTAX

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

描述

根據 Import-ADSyncToolsSourceAnchor 匯入 CSV 檔案產生 ms-ds-Consistency-Guid 報表

範例

範例 1

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

範例 2

Another example of how to use this cmdlet

PARAMETERS

-AlternativeLoginId

使用替代登入識別碼 (郵件)

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

CSV 和 LOG 檔案的輸出檔名

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Get-ADSyncToolsAadObject

概要

取得指定 SyncObjectType 的已同步物件

SYNTAX

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

描述

讀取 Microsoft Entra 中指定物件類別 (SyncObjectType) 的所有已同步物件。

範例

範例 1

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

PARAMETERS

-SyncObjectType

物件類型

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

-Credential

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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸出

此指令程式所傳回由同步用戶端所同步的 "Shadow" 屬性,可能與 Microsoft Entra ID 個別屬性中所儲存的實際值不同。 例如,使用未驗證網域尾碼 'user@nonverified.domain' 同步的使用者 UPN,在 Microsoft Entra ID 轉換為租用戶預設網域 'user@tenantname.onmicrosoft.com' 時,將會有 UPN 尾碼。 在此情況下,Get-ADSyncToolsAadObject 會傳回 'user@nonverified.domain' 的 "Shadow" 值,而不是 Microsoft Entra ID 'user@tenantname.onmicrosoft.com' 中的實際值。

Get-ADSyncToolsMsDsConsistencyGuid

概要

取得 Active Directory 物件 ms-ds-ConsistencyGuid

SYNTAX

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

描述

以 GUID 格式傳回目標 AD 使用者的 mS-DS-ConsistencyGuid 屬性值 支援在多網域樹系中 Active Directory 物件。

範例

範例 1

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

範例 2

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

範例 3

'User1@Contoso.com' | Get-ADSyncToolsMsDsConsistencyGuid

PARAMETERS

-身分識別

要在 AD 中取得的目標物件

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Get-ADSyncToolsRunHistory

概要

取得 Microsoft Entra Connect 執行歷程記錄

SYNTAX

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

描述

以 XML 格式傳回 Microsoft Entra Connect 執行歷程記錄的函式

範例

範例 1

Get-ADSyncToolsRunHistory

範例 2

Get-ADSyncToolsRunHistory -Days 3

PARAMETERS

-Days

傳回收集歷程記錄的天數 (預設值 = 1)

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Get-ADSyncToolsRunHistoryLegacyWmi

概要

取得舊版 Microsoft Entra Connect 的 Microsoft Connect 執行歷程記錄 (WMI)

SYNTAX

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

描述

以 XML 格式傳回 Microsoft Entra Connect 執行歷程記錄的函式

範例

範例 1

Get-ADSyncToolsRunHistory

範例 2

Get-ADSyncToolsRunHistory -Days 3

PARAMETERS

-Days

傳回收集歷程記錄的天數 (預設值 = 1)

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Get-ADSyncToolsSqlBrowserInstances

概要

取得 SQL Browser 服務的 SQL Server 執行個體

SYNTAX

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

描述

SQL 診斷相關功能和公用程式

範例

範例 1

Get-ADSyncToolsSqlBrowserInstances -Server 'sqlserver01'

PARAMETERS

伺服器-

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

概要

Helper 函式,可取得使用者所屬的 Azure 環境。

SYNTAX

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

描述

此函式會呼叫 OAuth 探索端點以取得 CloudInstance 和 tenant_region_scope 來判斷 Azure 環境。 https://login.microsoftonline.com/{tenant}/.well-known/openid-configuration

範例

範例 1

Get-ADSyncToolsTenantAzureEnvironment -Credential (Get-Credential)

PARAMETERS

-Credential

使用者的 PowerShell 認證物件:

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

使用者的 PowerShell 認證物件

輸出

Azure 環境 (字串)

Get-ADSyncToolsTls12

概要

取得 .NET Framework 的用戶端\伺服器 TLS 1.2 設定

SYNTAX

Get-ADSyncToolsTls12 [<CommonParameters>]

描述

從登錄讀取有關 .NET Framework 的 TLS 1.2 資訊:

路徑 名稱
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 已啟用
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server DisabledByDefault
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client 已啟用
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client DisabledByDefault

範例

範例 1

Get-ADSyncToolsTls12

PARAMETERS

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

如需詳細資訊,請參閱:對 Microsoft Entra Connect 強制執行 TLS 1.2 (部分機器翻譯)

Import-ADSyncToolsObjects

概要

從 XML 檔案匯入 Microsoft Entra Connect 物件

SYNTAX

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

描述

從使用 Export-ADSyncToolsObjects 匯出的 XML 檔案匯入內部 ADSync 物件

範例

範例 1

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

PARAMETERS

-Path

要匯入 XML 檔案的路徑

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Import-ADSyncToolsRunHistory

概要

匯入 Microsoft Entra Connect 執行歷程記錄

SYNTAX

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

描述

此函式會從使用 Export-ADSyncToolsRunHistory 建立的 XML 匯入 Microsoft Entra Connect 執行步驟結果

範例

範例 1

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

PARAMETERS

-Path

要匯入 XML 檔案的路徑

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Import-ADSyncToolsSourceAnchor

概要

從 Microsoft Entra ID 匯入 ImmutableID

SYNTAX

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

描述

以 GUID 格式產生檔案,其中為包含 ImmutableID 值的所有 Microsoft Entra ID 同步處理使用者。需求:MSOnline PowerShell 模組

範例

範例 1

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

範例 2

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

PARAMETERS

-Output

輸出 CSV 檔案

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

-IncludeSyncUsersFromRecycleBin

取得 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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Invoke-ADSyncToolsSqlQuery

概要

為資料庫叫用 SQL 查詢以進行測試

SYNTAX

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

描述

SQL 診斷相關功能和公用程式

範例

範例 1

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

範例 2

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

PARAMETERS

-SqlConnection

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

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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Remove-ADSyncToolsAadObject

概要

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

描述

根據 SourceAnchor 和 ObjecType,從 Microsoft Entra ID 中以一批為 10 個已同步的物件進行刪除。CSV 檔案可以使用 Export-ADSyncToolsAadDisconnectors 產生

範例

範例 1

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

範例 2

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

PARAMETERS

-Credential

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

CSV 輸入檔案名稱

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

-SourceAnchor

物件 SourceAnchor

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

-SyncObjectType

物件類型

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

InputCsvFilename 必須指向至少具有下列 2 個資料行的 CSV 檔案:SourceAnchor、SyncObjectType

輸出

顯示 ExportDeletions 作業結果的免責聲明:除了具有資源回收筒的使用者物件以外,其他使用此函數刪除的物件類型都無法復原!

Remove-ADSyncToolsAadPublicFolders

概要

從 Microsoft Entra ID 中移除擁有郵件功能的公用資料 (MEPF) 同步處理。 您可以為要刪除的目標 MEPF 物件指定一個 SourceAnchor/ImmutableID,或者在與 Export-ADSyncToolsAadPublicFolders 結合使用時,提供一個包含一批要刪除物件的 CSV 清單。 此函式需要 Microsoft Entra ID 中全域管理員的認證,不支援使用 MFA 進行驗證。 注意:如果已在租用戶上停用 DirSync,則您必須暫時重新啟用 DirSync,才能從 Microsoft Entra ID 中移除孤立擁有郵件功能的公用資料夾。

SYNTAX

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

描述

此函式可將 Microsoft Entra ID 中所有同步處理之擁有郵件功能的公用資料夾 (MEPF) 匯出為 CSV 檔案。 其可與 Remove-ADSyncToolsAadPublicFolders 結合使用,以識別和移除 Microsoft Entra ID 中孤立擁有郵件功能的公用資料夾。 此函式需要 Microsoft Entra ID 中全域管理員的認證,不支援使用 MFA 進行驗證。 注意:如果已在租用戶上停用 DirSync,則您必須暫時重新啟用 DirSync,才能從 Microsoft Entra ID 中移除孤立擁有郵件功能的公用資料夾。

範例

範例 1

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

範例 2

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

PARAMETERS

-Credential

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

輸入 CSV 檔案的路徑

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

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

您可以使用 Export-ADSyncToolsAadPublicFolders 來產生 CSV 輸入檔。 路徑參數必須指向至少具有下列 2 個資料行的 CSV 檔案:SourceAnchor、SyncObjectType

輸出

顯示 ExportDeletions 作業的結果。

Remove-ADSyncToolsExpiredCertificates

概要

從 UserCertificate 屬性移除過期憑證的指令碼

SYNTAX

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

描述

此指令碼會從 Active Directory 網域中的目標組織單位取得所有物件;依物件類別 (使用者/電腦) 篩選,並刪除 UserCertificate 屬性中的所有過期憑證。 預設 (BackupOnly 模式) 只會將過期憑證備份至檔案,並不會在 AD 中進行任何變更。 如果您使用 -BackupOnly $false,這些物件在複製到檔案之後,其 UserCertificate 屬性中的任何過期憑證都會從 Active Directory 中移除。 每個憑證都會備份至個別的檔名:ObjectClass_ObjectGUID_CertThumprint.cer。 指令碼也會以 CSV 格式建立記錄檔,顯示所有使用者的憑證是否有效或已過期,包括實際採取的動作 (已略過/已匯出/已刪除)。

範例

範例 1

檢查目標 OU 中的所有使用者 - 到期的憑證將會複製到個別的檔案,且不會移除任何憑證

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

範例 2

從目標 OU 中的所有電腦物件中刪除過期的憑證 - 過期的憑證將會複製到檔案,並從 AD 中移除

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

PARAMETERS

-TargetOU

要查閱 AD 物件的目標 OU

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

-BackupOnly

BackupOnly 不會從 AD 刪除任何憑證

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

-ObjectClass

物件類別篩選條件

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Repair-ADSyncToolsAutoUpgradeState

概要

修復 Microsoft Entra Connect AutoUpgrade 狀態

SYNTAX

Repair-ADSyncToolsAutoUpgradeState

描述

修正組建 1.1.524 (2017 年 5 月) 中導致的 AutoUpgrade 問題,該問題會在啟用 AutoUpgrade 時停用新版本的線上檢查。

範例

範例 1

Repair-ADSyncToolsAutoUpgradeState

Resolve-ADSyncToolsSqlHostAddress

概要

解析 SQL 的伺服器名稱

SYNTAX

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

描述

SQL 診斷相關功能和公用程式

範例

範例 1

Resolve-ADSyncToolsSqlHostAddress -Server 'sqlserver01'

PARAMETERS

伺服器-

SQL Server 名稱

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Search-ADSyncToolsADobject

概要

依據 Active Directory 物件的 UserPrincipalName、sAMAccountName 或 DistinguishedName 在 Active Directory 樹系中進行搜尋

SYNTAX

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

描述

支援多網域查詢,並傳回所有必要的屬性,包括 mS-DS-ConsistencyGuid。

範例

範例 1

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

範例 2

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

範例 3

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

PARAMETERS

-身分識別

AD 中要設定 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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Set-ADSyncToolsMsDsConsistencyGuid

概要

設定 Active Directory 物件 ms-ds-ConsistencyGuid

SYNTAX

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

描述

為目標 Active Directory 使用者設定 mS-DS-ConsistencyGuid 屬性中的值。 支援在多網域樹系中 Active Directory 物件。

範例

範例 1

Set-ADSyncToolsMsDsConsistencyGuid -Identity 'CN=User1,OU=Sync,DC=Contoso,DC=com' -Value '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'

範例 2

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

範例 3

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

範例 4

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

範例 5

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

範例 6

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

PARAMETERS

-身分識別

AD 中要設定 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

要設定的值 (ImmutableId、位元組陣列、GUID、GUID 字串或 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

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Set-ADSyncToolsTls12

概要

設定 .NET Framework 的用戶端\伺服器 TLS 1.2 設定

SYNTAX

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

描述

設定登錄項目以啟用/停用 .NET Framework 的 TLS 1.2:

路徑 名稱
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 已啟用
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server DisabledByDefault
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client 已啟用
HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client DisabledByDefault

執行沒有任何參數的 Cmdlet,將會為 .NET Framework 啟用 TLS 1.2

範例

範例 1

Set-ADSyncToolsTls12

範例 2

Set-ADSyncToolsTls12 -Enabled $true

PARAMETERS

-Enabled

已啟用 TLS 1.2

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

如需詳細資訊,請參閱:對 Microsoft Entra Connect 強制執行 TLS 1.2 (部分機器翻譯)

Test-ADSyncToolsSqlNetworkPort

概要

測試 SQL Server 網路連接埠

SYNTAX

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

描述

SQL 診斷相關功能和公用程式

範例

範例 1

Test-ADSyncToolsSqlNetworkPort -Server 'sqlserver01'

範例 2

Test-ADSyncToolsSqlNetworkPort -Server 'sqlserver01' -Port 1433

PARAMETERS

伺服器-

SQL Server 名稱

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

-Port

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

概要

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

描述

從指定的 Active Directory 浮水印檢查點 (也稱為分割區 Cookie) 追蹤 Active Directory 匯入執行的所有 LDAP 查詢。 在目前的資料夾上建立追蹤檔案 '.\ADimportTrace_yyyyMMddHHmmss.log'。 若要使用-ADConnectorXML,請移至 Synchronization Service Manager,以滑鼠右鍵按一下您的 AD 連接器,然後選取 [匯出連接器...]

範例

範例 1

藉由提供 AD 連接器 XML 檔案來追蹤使用者物件的 Active Directory 匯入

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

範例 2

藉由提供 Active Directory 浮水印 (Cookie) 和 AD 連接器認證來追蹤所有物件的 Active Directory 匯入

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

PARAMETERS

-DC

目標網域控制站

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

-RootDN

樹系根 DN

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

-Filter

要追蹤的 AD 物件類型。 針對所有物件類型使用 '(&(objectClass=*))'

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

-Credential

提供認證以針對 AD 執行 LDAP 查詢

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

-SSL

SSL 連線

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

-ADConnectorXML

AD 連接器匯出 XML 檔案:以滑鼠右鍵按一下 AD 連接器,然後選取 [匯出連接器...]

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

-ADwatermark

手動輸入浮水印,而不是 XML 檔案,例如 $ADwatermark = "TVNEUwMAAAAXyK9ir1zSAQAAAAAAAAAA(...)"

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Trace-ADSyncToolsLdapQuery

概要

追蹤 LDAP 查詢

SYNTAX

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

描述

{{ 填寫描述 }}

範例

範例 1

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

PARAMETERS

-RootDN

樹系/網域 DistinguishedName

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

-Credential

AD 認證

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

伺服器-

網域控制站名稱 (選用)

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

-Port

網域控制站連接埠 (預設值:389)

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

-Filter

LDAP 篩選 (預設值:objectClass=*)

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Update-ADSyncToolsSourceAnchor

概要

使用新的 ConsistencyGuid (ImmutableId) 來更新使用者

SYNTAX

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

描述

以從 ConsistencyGuid 報表取得的最新 ConsistencyGuid (ImmutableId) 值來更新使用者。 此函式支援 -WhatIf 參數。

注意:務必以定位字元分隔匯入 ConsistencyGuid 報表。

範例

範例 1

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

範例 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

動作

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

-Output

LOG 檔案的輸出檔名

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Get-ADSyncToolsDuplicateUsersSourceAnchor

概要

取得具有「來源錨點已變更」錯誤的所有物件清單。

SYNTAX

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

描述

在某些情況下,例如 M&A,客戶會將新的樹系新增至具有重複使用者物件的 Microsoft Entra Connect。 如果新加入的使用者的新連接器優先順序較高,這會導致多個同步處理錯誤。 此 Cmdlet 會提供具有「來源錨點已變更」錯誤的所有物件清單。

範例

範例 1

Get-ADSyncToolsDuplicateUsersSourceAnchor -ADConnectorName Contoso.com

PARAMETERS

-ADConnectorName

需要修復使用者來源錨點的 AD 連接器名稱

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

Set-ADSyncToolsDuplicateUsersSourceAnchor

概要

修正具有「來源錨點已變更」錯誤的所有物件。

SYNTAX

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

描述

此 Cmdlet 會從 Get-ADSyncToolsDuplicateUsersSourceAnchor 取得物件清單做為管線輸入。 然後,其會使用原始物件的 sourceAnchor/immutableID 更新 msDS-ConsistencyGuid 屬性,以修正同步錯誤。 Cmdlet 具有選擇性參數 - 「Override prompt」,預設為 False。 如果設定為 True,則更新 msDS-ConsistencyGuid 屬性時,將不會提示使用者。

範例

範例 1

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

範例 2

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

PARAMETERS

-DuplicateUserSourceAnchorInfo

需要修正來源錨點的使用者清單

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

-ActiveDirectoryCredential

AD EA/DA 管理員認證,如果未提供認證,則會使用預設認證

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

CommonParameters

這個 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutVariable、-OutBuffer、-PipelineVariable、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters