Test-ComputerSecureChannel

  • リファレンス
モジュール:
Microsoft.PowerShell.Management

ローカル コンピューターとそのドメインの間のセキュリティで保護されたチャネルをテストして修復します。

構文

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 共通パラメーターを使用して、操作に関する詳細なメッセージを要求します。 Verboseの詳細については、about_CommonParametersを参照してください。

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

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

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

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

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

この処理を実行するアクセス許可を持つユーザー アカウントを指定します。 User01 や Domain01\User01 などのユーザー名を入力するか、get-Credential コマンドレットから返されるオブジェクトなど、 PSCredential オブジェクトを入力します。 既定では、コマンドレットは現在のユーザーの資格情報を使用します。

Credential パラメーターは、コンピューターとドメインの間のチャネルを修復するために Repair パラメーターを使用するコマンドで使用するように設計されています。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Repair

このコマンドレットは、NetLogon サービスによって確立されたチャネルを削除して再構築することを示します。 テストに失敗した接続を復元するには、このパラメーターを使用します。

このパラメーターを使用するには、現在のユーザーは、ローカル コンピューター上の Administrators グループのメンバーである必要があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Server

コマンドを実行するドメイン コントローラーを指定します。 このパラメーターが指定されていない場合、このコマンドレットは操作の既定のドメイン コントローラーを選択します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

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

出力

Boolean

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

メモ

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