次の方法で共有

New-CimSessionOption

  • リファレンス
モジュール:
CimCmdlets

New-CimSession コマンドレットの詳細オプションを指定します。

構文

New-CimSessionOption
   [-Protocol] <ProtocolType>
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-NoEncryption]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-EncodePortInServicePrincipalName]
   [-Encoding <PacketEncoding>]
   [-HttpPrefix <Uri>]
   [-MaxEnvelopeSizeKB <UInt32>]
   [-ProxyAuthentication <PasswordAuthenticationMechanism>]
   [-ProxyCertificateThumbprint <String>]
   [-ProxyCredential <PSCredential>]
   [-ProxyType <ProxyType>]
   [-UseSsl]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]
New-CimSessionOption
   [-Impersonation <ImpersonationType>]
   [-PacketIntegrity]
   [-PacketPrivacy]
   [-UICulture <CultureInfo>]
   [-Culture <CultureInfo>]
   [<CommonParameters>]

説明

New-CimSessionOption コマンドレットは、CIM セッション オプション オブジェクトのインスタンスを作成します。 CIM セッションのオプションを指定するには、 New-CimSession コマンドレットへの入力として CIM セッション オプション オブジェクトを使用します。

このコマンドレットには、WsMan オプション用と分散コンポーネント オブジェクト モデル (DCOM) オプション用の 2 つのパラメーター セットがあります。 使用するパラメーターに応じて、コマンドレットは DCOM セッション オプションのインスタンスを返すか、WsMan セッション オプションを返します。

例

例 1: DCOM の CIM セッション・オプション・オブジェクトを作成する

この例では、DCOM プロトコルの CIM セッション オプション オブジェクトを作成し、 $soという名前の変数に格納します。 その後、変数の内容が New-CimSession コマンドレットに渡されます。 New-CimSession 次に、変数に定義されているオプションを使用して、Server01 という名前のリモート サーバーとの新しい CIM セッションを作成します。

$so = New-CimSessionOption -Protocol DCOM
New-CimSession -ComputerName Server01 -SessionOption $so

例 2: WsMan 用の CIM セッション・オプション・オブジェクトを作成する

この例では、WsMan プロトコル用の CIM セッション オプション オブジェクトを作成します。 オブジェクトには、ProxyAuthentication パラメーターで指定された Kerberos の認証モードの構成、ProxyCredential パラメーターで指定された資格情報が含まれており、コマンドが CA チェックをスキップし、CN チェックをスキップして SSL を使用することを指定します。

New-CimSessionOption -ProxyAuthentication Kerberos -ProxyCredential $cred -SkipCACheck -SkipCNCheck -UseSsl

例 3: カルチャを指定して CIM セッション・オプション・オブジェクトを作成する

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

この例では、CIM セッションに使用されるカルチャを指定します。 既定では、操作の実行時にクライアントのカルチャが使用されます。 ただし、既定のカルチャは、 Culture パラメーターを使用してオーバーライドできます。

パラメーター

-Culture

CIM セッションに使用するユーザー インターフェイス カルチャを指定します。 次のいずれかの形式を使用して、このパラメーターの値を指定します。

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

-EncodePortInServicePrincipalName

サービス プリンシパル名 (SPN) にサービス ポート番号が含まれるサービスに Kerberos 接続が接続していることを示します。 この種類の接続は一般的ではありません。

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

-Encoding

WsMan プロトコルに使用されるエンコードを指定します。 このパラメーターに使用できる値は、 Default、 Utf8、または Utf16 です。

型:PacketEncoding
指定可能な値:Default, Utf8, Utf16
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-HttpPrefix

コンピューター名とポート番号の後の HTTP URL の部分を指定します。 これを変更することは一般的ではありません。 既定では、このパラメーターの値は /wsman です。

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

-Impersonation

偽装を使用して Windows Management Instrumentation (WMI) への DCOM セッションを作成します。

このパラメーターで有効な値は下記です:

  • 既定値: DCOM は、通常のセキュリティ ネゴシエーション アルゴリズムを使用して偽装レベルを選択できます。
  • なし: クライアントはサーバーに対して匿名です。 サーバー プロセスはクライアントを偽装できますが、偽装トークンには情報が含まれていないので、使用できません。
  • Identify: オブジェクトによる呼び出し元の資格情報のクエリが許可されます。
  • Impersonate: オブジェクトによる呼び出し元の資格情報の使用が許可されます。
  • デリゲート: 他のオブジェクトが呼び出し元の資格情報を使用することをオブジェクトに許可します。

Impersonation が指定されていない場合、New-CimSession コマンドレットは Impersonate の値を使用します。

型:ImpersonationType
指定可能な値:Default, None, Identify, Impersonate, Delegate
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaxEnvelopeSizeKB

どちらの方向に対しても WsMan XML メッセージのサイズ制限を指定します。

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

-NoEncryption

データ暗号化を無効にすることを指定します。

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

-PacketIntegrity

WMI に対して作成された DCOM セッションがコンポーネント オブジェクト モデル (COM) PacketIntegrity 機能を使用することを指定します。 既定では、DCOM を使用して作成されたすべての CIM セッションでは、 PacketIntegrity パラメーターが True に設定されます。

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

-PacketPrivacy

COM PacketPrivacy を使用して WMI への DCOM セッションを作成します。 既定では、DCOM を使用して作成されたすべての CIM セッションでは、 PacketPrivacy パラメーターが true に設定されます。

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

-Protocol

使用するプロトコルを指定します。 このパラメーターに使用できる値は、 DCOM、 Default、または Wsman です。

型:ProtocolType
指定可能な値:Dcom, Default, Wsman
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProxyAuthentication

プロキシ解決に使用する認証方法を指定します。 このパラメーターに使用できる値は、 Default、 Digest、 Negotiate、 Basic、 Kerberos、 NtlmDomain、または CredSsp です。

型:PasswordAuthenticationMechanism
指定可能な値:Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProxyCertificateThumbprint

プロキシ認証用のユーザー アカウントの (x.509) デジタル公開キー証明書を指定します。 証明書の拇印を入力します。 証明書は、クライアント証明書ベースの認証で使用されます。 ローカル ユーザー アカウントにのみマップでき、ドメイン アカウントでは機能しません。

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

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

-ProxyCredential

プロキシ認証に使用する資格情報を指定します。 次のいずれかを入力します。

  • PSCredential オブジェクトを含む変数。
  • PSCredential オブジェクトを取得するコマンド (例: Get-Credential

このオプションが設定されていない場合は、資格情報を指定できません。

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

-ProxyType

使用するホスト名解決メカニズムを指定します。 このパラメーターに使用できる値は、 None、 WinHttp、 Auto、または InternetExplorer です。

このパラメーターの既定値は InternetExplorer です。

型:ProxyType
指定可能な値:None, WinHttp, Auto, InternetExplorer
配置:Named
規定値:InternetExplorer
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SkipCACheck

HTTPS 経由で接続するときに、クライアントはサーバー証明書が信頼された証明機関 (CA) によって署名されていることを検証しないことを示します。

このパラメーターは、リモート コンピューターが物理的に安全で分離されたネットワークの一部である場合や、リモート コンピューターが WinRM 構成で信頼されたホストとして表示されている場合など、別のメカニズムを使用してリモート コンピューターが信頼されている場合にのみ使用します。

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

-SkipCNCheck

サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを示します。 このパラメーターは、HTTPS プロトコルを使用する信頼されたコンピューターでのみリモート操作に使用します。

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

-SkipRevocationCheck

サーバー証明書の失効チェックがスキップされることを示します。 このパラメーターは、信頼できるコンピューターに対してのみ使用します。

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

-UICulture

CIM セッションに使用するユーザー インターフェイス カルチャを指定します。 次のいずれかの形式を使用して、このパラメーターの値を指定します。

  • "EN-US" などの <languagecode2>-<country/regioncode2> 形式のカルチャ名。
  • CultureInfo オブジェクトを含む変数。
  • Get-Cultureなどの CultureInfo オブジェクトを取得するコマンド。
型:CultureInfo
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-UseSsl

SSL を使用してリモート コンピューターへの接続を確立する必要があることを示します。 既定では、SSL は使用されません。 WsMan は、HTTP を使用している場合でも、ネットワーク経由で送信されるすべてのコンテンツを暗号化します。

このパラメーターを使用すると、HTTP ではなく HTTPS の追加保護を指定できます。 接続に使用されているポートで SSL を使用できず、このパラメーターを指定すると、コマンドは失敗します。

このパラメーターは、 PacketPrivacy パラメーターが指定されていない場合にのみ使用することをお勧めします。

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

入力

None

このコマンドレットにオブジェクトをパイプすることはできません。

出力

CimSessionOptions

このコマンドレットは、CIM セッション オプション情報を含むオブジェクトを返します。