Set-EntraDirSyncEnabled
会社のディレクトリ同期をオンまたはオフにします。
構文
Default (既定)
Set-EntraDirSyncEnabled
-EnableDirSync <Boolean>
[-Force]
[-TenantId <String>]
[<CommonParameters>]
説明
Set-EntraDirSyncEnabled コマンドレットは、会社のディレクトリ同期をオンまたはオフにします。
DirSync を有効または再び有効にすると、テナントに新しいサービス プリンシパルが表示されます。 appId 6bf85cfa-ac8a-4be5-b5de-425a0d0dc016と、AD 同期サービスMicrosoft Entra表示名があります。
クラウド サブスクリプション内のオブジェクトの数によっては、DirSync の非アクティブ化に最大 72 時間かかることがあります。 無効にすると、プロセスを取り消すことはできず、DirSync の再有効化など、さらにアクションを実行する前に完了する必要があります。
DirSync を再び有効にすると、完全同期が実行され、Microsoft Entra ID内のオブジェクトの数に基づいてかなりの時間がかかる場合があります。
さらに、BlockCloudObjectTakeoverThroughHardMatchが有効になっている場合、DirSync を再度有効にすると、すべてのMicrosoft Entra IDマスター オブジェクトに対するオンプレミスからクラウド へのオブジェクトの引き継ぎ/更新がブロックされます。 これらのオブジェクトの同期を許可するには、 BlockCloudObjectTakeoverThroughHardMatch を false に設定します。
例
例 1: ディレクトリ同期を有効にする
Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
Set-EntraDirSyncEnabled -EnableDirsync $true -Force $true
次の使用例は、会社のディレクトリ同期を有効にします。
-
-EnableDirsync会社のディレクトリ同期を有効にするかどうかを指定します。 -
-Forceユーザーの確認を求めずにコマンドを強制的に実行します。
例 2: ディレクトリ同期を無効にする
Connect-Entra -Scopes 'OnPremDirectorySynchronization.ReadWrite.All', 'Organization.ReadWrite.All'
$tenantID = (Get-EntraContext).TenantId
Set-EntraDirSyncEnabled -EnableDirsync $false -TenantId $tenantID -Force
次の使用例は、会社のディレクトリ同期をオフにします。
-
-EnableDirsync会社のディレクトリ同期を有効にするかどうかを指定します。 -
-Forceユーザーの確認を求めずにコマンドを強制的に実行します。 -
-TenantId操作を実行するテナントの一意の ID を指定します。
パラメーター
-EnableDirsync
会社のディレクトリ同期を有効にするかどうかを指定します。
パラメーターのプロパティ
| 型: | System.Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Force
ユーザーの確認を求めずにコマンドを強制的に実行します。
パラメーターのプロパティ
| 型: | System.Management.Automation.SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-TenantId
操作を実行するテナントの一意の ID を指定します。 このパラメーターは、パートナー シナリオAzure AD および MSOnline との互換性を提供します。 TenantID は、サインインしているユーザーのテナント ID です。
パラメーターのプロパティ
| 型: | System.String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。