New-CimSessionOption

構文

ProtocolTypeSet (既定)

New-CimSessionOption
    [-Protocol] <ProtocolType>
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

WSManParameterSet

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>]

DcomParameterSet

New-CimSessionOption
    [-Impersonation <ImpersonationType>]
    [-PacketIntegrity]
    [-PacketPrivacy]
    [-UICulture <CultureInfo>]
    [-Culture <CultureInfo>]
    [<CommonParameters>]

説明

例

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

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

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

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

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

New-CimSessionOption -Culture Fr-Fr -Protocol Wsman

パラメーター

-Culture

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

カルチャ名を "EN-US" などの <languagecode2>-<country/regioncode2> 形式で入力します。

CultureInfo オブジェクトを含む変数。

CultureInfo オブジェクトを取得するコマンド、例えば Get-Culture など。

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

パラメーター セット

-EncodePortInServicePrincipalName

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

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

パラメーター セット

-Encoding

WsMan プロトコルに使用されるエンコードを指定します。

このパラメーターに指定できる値は、Default、Utf8、または Utf16 です。

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

パラメーター セット

-HttpPrefix

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

デフォルトでは、このパラメータの値は /wsman です。

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

パラメーター セット

-Impersonation

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

このパラメーターの有効な値は次のとおりです。

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

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

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

パラメーター セット

-MaxEnvelopeSizeKB

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

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

パラメーター セット

-NoEncryption

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

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

パラメーター セット

-PacketIntegrity

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

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

パラメーター セット

-PacketPrivacy

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

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

パラメーター セット

-Protocol

使用するプロトコルを指定します。

このパラメーターに指定できる値は、DCOM または WinRM です。

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

パラメーター セット

-ProxyAuthentication

プロキシ解決に使用する認証方法を指定します。

このパラメーターに指定できる値は、Default、Digest、Negotiate、Basic、Kerberos、NtlmDomain、または CredSsp です。

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

パラメーター セット

-ProxyCertificateThumbprint

プロキシ認証用のユーザー アカウントの (x.509) デジタル公開キー証明書を指定します。 証明書の拇印を入力します。

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

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

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

パラメーター セット

-ProxyCredential

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

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

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

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

パラメーター セット

-ProxyType

使用するホスト名解決メカニズムを指定します。

このパラメーターに指定できる値は、None、WinHttp、Auto、または InternetExplorer です。

デフォルトでは、このパラメータの値は InternetExplorer です。

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

パラメーター セット

-SkipCACheck

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

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

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

パラメーター セット

-SkipCNCheck

サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを示します。

このパラメータは、HTTPS プロトコルを使用するリモート操作にのみ使用してください。

注: このパラメータは、信頼できるコンピュータにのみ使用してください。

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

パラメーター セット

-SkipRevocationCheck

サーバー証明書の失効チェックがスキップされることを示します。

注: このパラメータは、信頼できるコンピュータにのみ使用してください。

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

パラメーター セット

-UICulture

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

• カルチャ名を "EN-US" などの <languagecode2>-<country/regioncode2> 形式で入力します。
• CultureInfo オブジェクトを含む変数。
• Get-Cultureなどの CultureInfo オブジェクトを取得するコマンド。

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

パラメーター セット

-UseSsl

SSL を使用してリモート コンピューターへの接続を確立する必要があることを示します。 既定では、SSL は使用されません。

WsMan は、ネットワーク経由で送信されるすべてのコンテンツを暗号化します。 このパラメーターを使用すると、HTTP ではなく HTTPS の追加保護を指定できます。 接続に使用されているポートで SSL を使用できず、このパラメーターを指定すると、コマンドは失敗します。

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

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

パラメーター セット

CommonParameters

入力

None

出力

CIMSessionOption

関連リンク

• Get-ChildItem
• Get-Credential
• Get-Culture
• Get-Item
• New-CimSession