New-CimSession

ユーザーの資格情報に使用される認証の種類を指定します。 このパラメーターに使用できる値は次のとおりです。

• 既定値
• ダイジェスト
• 交渉する
• Basic
• Kerberos
• NtlmDomain
• CredSsp

ローカル コンピューターへの接続には、NtlmDomain 認証の種類を使用することはできません。 CredSSP 認証は、Windows Vista、Windows Server 2008、およびそれ以降のバージョンの Windows でのみ使用できます。

このアクションを実行するアクセス許可を持つユーザー アカウントのデジタル公開キー証明書 (X.509) を指定します。 証明書の拇印を入力します。

証明書は、クライアント証明書ベースの認証で使用されます。 これらはローカル ユーザー アカウントにのみマップできます。ドメイン アカウントでは機能しません。

証明書の拇印を取得するには、PowerShell 証明書プロバイダーの Get-Item または Get-ChildItem コマンドレットを使用します。

詳細については、about_Certificate_Providerを参照してください。

CIM セッションを作成するコンピューターの名前を指定します。 1 つのコンピューター名、または複数のコンピューター名をコンマで区切って指定します。

ComputerName が指定されていない場合は、ローカル コンピューターへの CIM セッションが作成されます。 コンピューター名の値は、次のいずれかの形式で指定できます。

• 1 つ以上の NetBIOS 名
• 1 つ以上の IP アドレス
• 1 つ以上の完全修飾ドメイン名。

コンピューターがユーザーとは異なるドメインにある場合は、完全修飾ドメイン名を指定する必要があります。

このアクションを実行するアクセス許可を持つユーザー アカウントを指定します。 資格情報 が指定されていない場合は、現在のユーザー アカウントが使用されます。

次のいずれかの形式を使用して、資格情報 の値を指定します。

• ユーザー名: "User01"
• ドメイン名とユーザー名: "Domain01\User01"
• ユーザー プリンシパル名: "User@Domain.com"
• psCredential オブジェクト (Get-Credential コマンドレットによって返されるオブジェクトなど)。

ユーザー名を入力すると、パスワードの入力を求められます。

CIM セッションのフレンドリ名を指定します。

Get-CimSession コマンドレットなど、他のコマンドレットを使用する場合は、名前を使用して CIM セッションを参照できます。 名前は、コンピューターまたは現在のセッションに対して一意である必要はありません。

コマンドレットがサーバーからの応答を待機する期間。

既定では、このパラメーターの値は 0 です。これは、コマンドレットがサーバーの既定のタイムアウト値を使用することを意味します。

OperationTimeoutSec パラメーターが、堅牢な接続再試行タイムアウトの 3 分未満の値に設定されている場合、OperationTimeoutSec パラメーターの値を超えるネットワーク 障害は復旧できません。これは、クライアントが再接続する前にサーバーでの操作がタイムアウトするためです。

この接続に使用されるリモート コンピューター上のネットワーク ポートを指定します。 リモートコンピューターに接続するには、接続に使用するポートでリモートコンピューターが待機している必要があります。 既定のポートは、5985 (HTTP の WinRM ポート) と 5986 (HTTPS の WinRM ポート) です。

代替ポートを使用する前に、そのポートでリッスンするようにリモート コンピューター上の WinRM リスナーを構成する必要があります。 リスナーを構成するには、次のコマンドを使用します。

winrm delete winrm/config/listener?Address=*+Transport=HTTP

winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number>"}

必要な場合を除き、Port パラメーターは使用しないでください。 コマンドのポート設定は、コマンドを実行するすべてのコンピューターまたはセッションに適用されます。 代替ポート設定により、コマンドがすべてのコンピューターで実行できなくなる可能性があります。

新しい CIM セッションの詳細オプションを設定します。 コマンドレットを使用して作成された New-CimSessionOption オブジェクトの名前を入力します。

既定では、New-CimSession コマンドレットは、リモート WS-Management エンドポイントとの接続を確立します。リモート サーバーが Port パラメーターを使用して指定されたポート番号をリッスンしていることを確認し、指定されたアカウント資格情報を確認します。 検証は、標準の WS-Identity 操作を使用して実行されます。 リモート WS-Management エンドポイントで WS-Identify を使用できない場合、またはデータ転送時間を短縮する場合は、SkipTestConnection スイッチ パラメーターを追加できます。