PowerShell の MID サーバーのパラメーター

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間:7分
  • パラメーターは特定の MID サーバーの動作を制御し、MID サーバープロパティよりも優先順位が低いです。

    次のパラメーターはオプションです。
    注:
    パラメーターの設定を変更した後は、MID サーバー サービスを再起動してください。
    名前 説明
    mid.powershell_api.session_pool.max_size

    セッションプールで許可されるセッションの最大数を指定します。

    注:
    このパラメーターを設定または変更するには、MID サーバーを再起動する必要があります。
    • タイプ:整数
    • デフォルト値:25
    mid.powershell_api.session_pool.target.max_size

    ターゲットホストごとにプールで許可されるセッションの最大数を指定します。

    注:
    このパラメーターを設定または変更するには、MID サーバーを再起動する必要があります。
    • タイプ:整数
    • デフォルト値:3
    mid.powershell_api.winrm.use_ssl WinRM を使用する HTTPS 接続には SSL 証明書の使用が必要です。
    • タイプ:True | False
    • デフォルト値:false
    mid.powershell_api.winrm.additional_pssesion_options PSSession の詳細オプションを制御します。詳細な PSSession オプションの詳細については、「https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/new-pssessionoption?view=powershell-6」を参照してください。
    mid.powershell_api.winrm.remote_https_port HTTPS 上で PowerShell を使用する Windows サーバーに接続するためのポートを設定します。
    • タイプ:整数
    • デフォルト値:5986
    mid.powershell_api.winrm.remote_port HTTP 上で PowerShell を使用する Windows サーバーに接続するためのポートを設定します。
    • タイプ:整数
    • デフォルト値:5985
    mid.powershell_api.winrm.skip_ssl_cert_check HTTPS 接続に WinRM を使用するときは SSL 証明書の確認をスキップします。
    • タイプ:True | False
    • デフォルト値:false
    mid.powershell_api.winrm.skip_ssl_cert_check_options
    HTTPS 接続に WinRM を使用するときは特定の SSL 証明書の確認をスキップします。認証局 (CA) からの証明書、証明書に関連付けられたホストを識別する共通名 (CN) からの証明書、および失効した証明書の確認をスキップするよう MID サーバーを設定します。
    • タイプ:文字列
    • デフォルト値:-SkipCACheck -SkipCNCheck -SkipRevocationCheck
    mid.powershell_api.wmi.use_reverse_dns_lookup

    WMI プロトコルを使用して Windows ターゲット デバイスと通信するときに Kerberos 認証を使用するには、このプロパティを有効にします。有効にすると、システムは IP アドレスの逆引き DNS ルックアップを実行し、IP アドレスの代わりに完全修飾ドメイン名 (FQDN) を使用できるようになります。これにより、Kerberos 認証が容易になります。

    注:
    注: DNS の逆引きルックアップに失敗した場合、システムは IP アドレスの使用に戻る可能性があります。さらに、IP アドレスに対して逆引き DNS ルックアップを実行すると、パフォーマンスに影響を与える可能性があります。
    • タイプ:True | False

    • デフォルト値:False

    mid.powershell.use_credentials
    PowerShell で ディスカバリー を使用するための認証情報を判断します。true に設定すると、MID サーバーはプローブを実行するために認証情報テーブルから Windows 認証情報を使用します。MID サーバーサービスでユーザーの認証情報を使用してプローブを実行するには、このパラメーターを false に設定します。
    • タイプ:true | false
    • デフォルト値:true
    mid.use_powershell
    ディスカバリー の PowerShell を有効または無効にします。値を変更後、MID サーバーを再起動します。PowerShell がインストールされていないか、インストールされているバージョンがバージョン 2.0 より古い場合、ディスカバリーは WMIRunner の使用に戻ります。
    • タイプ:true | false
    • デフォルト値:true
    mid.powershell.path

    複数の PowerShell がインストールされている場合、アドミニストレーターは MID サーバー 上の特定の PowerShell をポイントできます。PowerShell 実行可能ファイルを含むフォルダー (たとえば、C:\mypowershell または C:\mypowershell\) へのパスを指定します。ServiceNow は文字列 powershell.exe をパスに自動的に追加します。32 ビットおよび 64 ビット PowerShell の両方が同じ MID サーバーでアクティブなときにこのパラメーターを設定します。そのコンテキストでは正しい PowerShell を起動することが必要になります。64 ビット Windows はファイルシステムリダイレクトを採用し、MID サーバーは 32 ビットアプリケーションとして動作します。%WinDir%\System32 にパスを指定すると、Windows は自動的に %WinDir%\SysWOW64 にリダイレクトします。リダイレクトを回避するには、パスを %WinDir%\Sysnative として指定します。たとえば、C:\WINDOWS\system32\WindowsPowerShell\v1.0\ の代わりに、C:\WINDOWS\sysnative\WindowsPowerShell\v1.0\ を指定します。

    注:
    Windows XP の 64 ビットバージョンでは、この機能を有効にするために Microsoft ホットフィックスが必要な場合があります。

    64 ビット Windows マシン上で実行するアプリケーションを検出するため、MID サーバー は 64 ビット Windows ホストマシン上で実行する必要があります。

    • タイプ:文字列 (パス)
    • デフォルト値:なし
    mid.powershell.enforce_utf8 このパラメーターを有効にすると、ターゲットの Windows システム上のコマンドは UTF-8 エンコードされた出力を返します。無効にすると、ターゲット システムはデフォルトのエンコーディングを使用できます。このパラメーターは、PowerShell が有効な場合にのみ有効です。

    この値を false に設定すると、プローブによって非 ASCII 文字が返された場合に CMDB の値が不正になる可能性があります。

    • タイプ:true | false
    • デフォルト値:true
    mid.powershell.local_mid_service_credential_fallback 他のすべての認証情報が失敗した場合に、MID サーバーが使用するログイン認証情報を指定します。
    • タイプ:True | False
    • デフォルト値:true
    mid.powershell_api.idle_session_timeout

    アイドル状態の PowerShell セッションのタイムアウト値を秒単位で指定します。

    注:
    このパラメーターを設定または変更するには、MID サーバー を再起動する必要があります。
    • タイプ:整数
    • デフォルト値:60
    mid.powershell.command.parameter_passing このパラメーターを有効にすると、コマンドラインから PowerShell パラメーターを渡すことができます。
    • タイプ:True | False
    • デフォルト値:false
    mid.powershell.command.script.parameter_passing このパラメーターを有効にすると、コマンドラインから PowerShell スクリプトを渡すことができます。
    • タイプ:True | False
    • デフォルト値:false
    mid.windows.management_protocol
    デバイスおよびプロセスの分類に使用される Windows 管理プロトコルをアドミニストレーターが選択できるようにします。次のオプションが含まれます。
    • WMI
    • WinRM
    • タイプ:文字列
    • デフォルト値:WMI
    mid.windows.probe_timeout 特定の MID サーバー上のすべての Windows プローブのタイムアウト間隔を設定します。この値は、wmi_timeout プローブ パラメーターを使用して個々のプローブに対して設定された値によって上書きされます。
    • タイプ:整数
    • デフォルト値:600