Test-ComputerSecureChannel

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

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

構文

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

説明

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

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

このコマンドレットは次のように NetDom.exe動作します。 NetDom と Test-ComputerSecureChannel NetLogon サービスの両方を使用してアクションを実行します。

例

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

Test-ComputerSecureChannel

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

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

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

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

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

Test-ComputerSecureChannel -Repair

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

例 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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

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

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repair

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

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Server

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

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

出力

Boolean

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

メモ

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