Test-ComputerSecureChannel

構文

Test-ComputerSecureChannel
    [-Repair]
    [-Server <String>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Test-ComputerSecureChannel コマンドレットは、ローカル コンピューターとそのドメイン間のチャネルが正常に動作していることを確認します。その信頼関係の状態を確認します。 接続に失敗した場合は、Repair パラメーターを使用して復元を試みることができます。

Test-ComputerSecureChannel は、チャネルが正常に動作している場合は$Trueを返し、正しくない場合は$Falseします。 この結果により、関数とスクリプトの条件付きステートメントでコマンドレットを使用できます。 より詳細なテスト結果を取得するには、Verbose パラメーターを使用します。

このコマンドレットは、NetDom.exeとよく似ています。 NetDom と Test-ComputerSecureChannel の両方で、NetLogon サービスを使用してアクションを実行します。

例

例 1: ローカル コンピューターとそのドメインの間のチャネルをテストする

Test-ComputerSecureChannel

このコマンドは、ローカル コンピューターと参加しているドメインの間のチャネルをテストします。

例 2: ローカル コンピューターとドメイン コントローラーの間のチャネルをテストする

Test-ComputerSecureChannel -Server "DCName.fabrikam.com"
True

このコマンドは、テスト用の優先ドメイン コントローラーを指定します。

例 3: ローカル コンピューターとそのドメインの間のチャネルをリセットする

Test-ComputerSecureChannel -Repair

このコマンドは、ローカル コンピューターとそのドメインの間のチャネルをリセットします。

例 4: テストに関する詳細情報を表示する

Test-ComputerSecureChannel -Verbose

VERBOSE: Performing operation "Test-ComputerSecureChannel" on Target "SERVER01".
True
VERBOSE: "The secure channel between 'SERVER01' and 'net.fabrikam.com' is alive and working correctly."

このコマンドは、Verbose 共通パラメーターを使用して、操作に関する詳細なメッセージを要求します。 詳細 の詳細については、「about_CommonParameters」を参照してください。

例 5: スクリプトを実行する前に接続をテストする

if (!(Test-ComputerSecureChannel)) {
    Write-Host "Connection failed. Reconnect and retry."
}
else {
    &(.\Get-Servers.ps1)
}

この例では、接続を必要とするスクリプトを実行する前に、Test-ComputerSecureChannel を使用して接続をテストする方法を示します。

if ステートメントは、スクリプトを実行する前 Test-ComputerSecureChannel 返される値をチェックします。

パラメーター

-Confirm

-Credential

-Repair

-Server

-WhatIf

入力

None

このコマンドレットに入力をパイプすることはできません。

出力

Boolean

このコマンドレットは、接続が正常に動作している場合は $True を返し、正しくない場合は $False します。

メモ

• Windows Vista 以降のバージョンの Windows オペレーティング システムで Test-ComputerSecureChannel コマンドを実行するには、[管理者として実行] オプションを使用して Windows PowerShell を開きます。
• Test-ComputerSecureChannel は、Netlogon サービスのさまざまな側面を制御する I_NetLogonControl2 関数を使用して実装されます。

関連リンク

• Checkpoint-Computer
• Reset-ComputerMachinePassword
• Restart-Computer
• Stop-Computer