次の方法で共有

Test-ComputerSecureChannel

モジュール:
Microsoft.PowerShell.Management Module

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

構文

Default (既定) 

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

説明

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

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

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

注

このコマンドレットは、ドメイン メンバー コンピューターでのみ機能します。 ドメイン コントローラーで実行すると、誤検知エラーが返されます。 ドメイン コントローラーのセキュリティで保護されたチャネルを確認してリセットするには、 netdom.exe または nltest.exeを使用します。

例

例 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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Credential

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

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

パラメーターのプロパティ

型:PSCredential
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Repair

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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Server

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

None

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

出力

Boolean

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

メモ

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