New-CimSessionOption
New-CimSession コマンドレットの詳細オプションを指定します。
構文
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>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
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 を使用することを指定します。
$option = @{
ProxyAuthentication = 'Kerberos'
ProxyCredential = $cred
SkipCACheck = $true
SkipCNCheck = $true
UseSsl = $true
}
New-CimSessionOption @option
例 3: カルチャを指定して CIM セッション・オプション・オブジェクトを作成する
New-CimSessionOption -Culture fr-FR -Protocol Wsman
この例では、CIM セッションに使用されるカルチャを指定します。 既定では、操作の実行時にクライアントのカルチャが使用されます。 ただし、既定のカルチャは Culture パラメーターを 使用してオーバーライドできます。
パラメーター
-Culture
CIM セッションに使用するユーザー インターフェイス カルチャを指定します。 次のいずれかの形式を使用して、このパラメーターの値を指定します。
- "en-US" などの
<languagecode2>-<country/regioncode2>形式のカルチャ名。 - CultureInfo オブジェクトを含む変数。
- Get-Culture などの CultureInfo オブジェクトを取得するコマンド
パラメーターのプロパティ
| 型: | CultureInfo |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-EncodePortInServicePrincipalName
サービス プリンシパル名 (SPN) にサービス ポート番号が含まれるサービスに Kerberos 接続が接続していることを示します。 この種類の接続は一般的ではありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Encoding
WsMan プロトコルに使用されるエンコードを指定します。 このパラメーターに使用できる値は、 Default、 Utf8、 または Utf16 です。
パラメーターのプロパティ
| 型: | PacketEncoding |
| 規定値: | None |
| 指定可能な値: | Default, Utf8, Utf16 |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-HttpPrefix
コンピューター名とポート番号の後の HTTP URL の部分を指定します。 これを変更することは一般的ではありません。 既定では、このパラメーターの値は /wsman です。
パラメーターのプロパティ
| 型: | Uri |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Impersonation
偽装を使用して管理インストルメンテーション (WMI) をWindowsする DCOM セッションを作成します。
PasswordQuality パラメーターは、デバイス パスワードに必要なパスワードの最小品質レベルを指定します。パスワードの品質は、パスワードのセキュリティと複雑さを示す数値の尺度です。品質の値が大きいほど、より安全なパスワードであることを示します。
- 既定値: DCOM は、通常のセキュリティ ネゴシエーション アルゴリズムを使用して偽装レベルを選択できます。
- なし: クライアントはサーバーに対して匿名です。 サーバー プロセスはクライアントを偽装できますが、偽装トークンには情報が含まれていないので、使用できません。
- 識別: オブジェクトが呼び出し元の資格情報を照会できるようにします。
- 偽装: オブジェクトが呼び出し元の資格情報を使用できるようにします。
- デリゲート: 他のオブジェクトが呼び出し元の資格情報を使用することをオブジェクトに許可します。
偽装が指定されていない場合、New-CimSession コマンドレットは Impersonate の値を使用します。
パラメーターのプロパティ
| 型: | ImpersonationType |
| 規定値: | None |
| 指定可能な値: | Default, None, Identify, Impersonate, Delegate |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DcomParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxEnvelopeSizeKB
どちらの方向に対しても WsMan XML メッセージのサイズ制限を指定します。
パラメーターのプロパティ
| 型: | UInt32 |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-NoEncryption
データ暗号化を無効にすることを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PacketIntegrity
WMI に対して作成された DCOM セッションで、コンポーネント オブジェクト モデル (COM) PacketIntegrity 機能を使用することを指定します。 既定では、DCOM を使用して作成されたすべての CIM セッションでは 、PacketIntegrity パラメーターが True に設定 されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DcomParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PacketPrivacy
COM PacketPrivacy を使用して WMI への DCOM セッションを作成します。 既定では、DCOM を使用して作成されたすべての CIM セッションでは 、PacketPrivacy パラメーターが true に設定 されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DcomParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Protocol
使用するプロトコルを指定します。 このパラメーターに使用できる値は 、Dcom、 Default、または Wsman です。
パラメーターのプロパティ
| 型: | ProtocolType |
| 規定値: | None |
| 指定可能な値: | Dcom, Default, Wsman |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ProtocolTypeSet
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ProxyAuthentication
プロキシ解決に使用する認証方法を指定します。 このパラメーターに使用できる値は、 Default、 Digest、 Negotiate、 Basic、 Kerberos、 NtlmDomain、 CredSsp です。
パラメーターのプロパティ
| 型: | PasswordAuthenticationMechanism |
| 規定値: | None |
| 指定可能な値: | Default, Digest, Negotiate, Basic, Kerberos, NtlmDomain, CredSsp |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ProxyCertificateThumbprint
プロキシ認証用のユーザー アカウントの (x.509) デジタル公開キー証明書を指定します。 証明書の拇印を入力します。 証明書は、クライアント証明書ベースの認証で使用されます。 ローカル ユーザー アカウントにのみマップでき、ドメイン アカウントでは機能しません。
証明書の拇印を取得するには、PowerShell Get-Item ドライブのGet-ChildItemまたはCert:コマンドレットを使用します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ProxyCredential
プロキシ認証に使用する資格情報を指定します。 次のいずれかを入力します。
- PSCredential オブジェクトを含む変数。
- PSCredential オブジェクトを取得するコマンド (例:
Get-Credential
このオプションが設定されていない場合は、資格情報を指定できません。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ProxyType
使用するホスト名解決メカニズムを指定します。 このパラメーターに使用できる値は 、None、 WinHttp、 Auto、または InternetExplorer です。
このパラメーターの既定値は InternetExplorer です。
パラメーターのプロパティ
| 型: | ProxyType |
| 規定値: | InternetExplorer |
| 指定可能な値: | None, WinHttp, Auto, InternetExplorer |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkipCACheck
HTTPS 経由で接続するときに、クライアントはサーバー証明書が信頼された証明機関 (CA) によって署名されていることを検証しないことを示します。
このパラメーターは、リモート コンピューターが物理的に安全で分離されたネットワークの一部である場合や、リモート コンピューターが WinRM 構成で信頼されたホストとして表示されている場合など、別のメカニズムを使用してリモート コンピューターが信頼されている場合にのみ使用します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkipCNCheck
サーバーの証明書共通名 (CN) がサーバーのホスト名と一致する必要がないことを示します。 このパラメーターは、HTTPS プロトコルを使用する信頼されたコンピューターでのみリモート操作に使用します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-SkipRevocationCheck
サーバー証明書の失効チェックがスキップされることを示します。 このパラメーターは、信頼できるコンピューターに対してのみ使用します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-UICulture
CIM セッションに使用するユーザー インターフェイス カルチャを指定します。 次のいずれかの形式を使用して、このパラメーターの値を指定します。
- "en-US" などの
<languagecode2>-<country/regioncode2>形式のカルチャ名。 - CultureInfo オブジェクトを含む変数。
-
Get-Cultureなどの CultureInfo オブジェクトを取得するコマンド。
パラメーターのプロパティ
| 型: | CultureInfo |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-UseSsl
SSL を使用してリモート コンピューターへの接続を確立する必要があることを示します。 既定では、SSL は使用されません。 WsMan は、HTTP を使用している場合でも、ネットワーク経由で送信されるすべてのコンテンツを暗号化します。
このパラメーターを使用すると、HTTP ではなく HTTPS の追加保護を指定できます。 接続に使用されているポートで SSL を使用できず、このパラメーターを指定すると、コマンドは失敗します。
このパラメーターは、 PacketPrivacy パラメーターが指定されていない場合にのみ使用することをお勧めします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
WSManParameterSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
CimSessionOptions
このコマンドレットは、CIM セッション オプション情報を含むオブジェクトを返します。
メモ
PowerShell には、New-CimSessionOptionの次のエイリアスが含まれています。
- ウィンドウズ:
ncso
このコマンドレットは、Windows プラットフォームでのみ使用できます。