---
sourceDocument: Xanadu IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/it-operations-management

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# PowerShell プローブ

# PowerShell プローブ {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分

PowerShell プローブは、MID サーバーホストで PowerShell V2 スクリプトを実行します。
PowerShell スクリプトは、パラメーター名としてファイル名を持つプローブパラメーターとして定義されます。プローブの ECC キュートピックとして PowerShell を指定すると、プローブのプローブタイプとして使用できます。

## PowerShell プローブパラメーター {#c_PowershellProbe__section_alf_pdg_dcb}

{#c_PowershellProbe__table_thk_ngg_dcb__entry__2}

| パラメーター名 | 説明 |
|-|-|
| ソース | \[必要\] 接続する最初のホストです。 デフォルト：なし |
| \<script name\>.ps1 | \[必要\] 実行する PowerShell スクリプトのファイル名です。有効なファイル名のプリフィックスで \<script name\> を置き換えます。 デフォルト：なし |
| powershell_command_parameter_passing | コマンドラインでスクリプトパラメーターを渡すかどうかを指定します。このパラメーターの値に関係なく、ServiceNow ではコマンドライン上のすべてのスクリプトパラメーターを環境変数として自動的に PowerShell スクリプトで使用できるようにしています。 デフォルト：false |
| powershell_param_\<script parameter name\> | 実行する PowerShell スクリプトに追加のパラメーターを渡します。各パラメーターは、スクリプト内では $env:SNC_\<script parameter name\> という形式の環境変数になります。このプリフィックスを持つパラメーターは暗号化されていないとみなされ、そのままスクリプトに渡されます。powershell_param_\<script parameter name\> と powershell_\<script parameter name\> の間で適切なパラメーターを選択していることを確認してください。誤ったプリフィックスを使用すると、PowerShell の実行でエラーが発生します。これは、ECC キュー入力内のインスタンスに戻されます。 デフォルト：なし |
| powershell_\<script parameter name\> | 実行する PowerShell スクリプトに追加のパラメーターを渡します。各パラメーターは、スクリプト内では $env:SNC_\<script parameter name\> という形式の環境変数になります。MID サーバーでは、このプリフィックスを持つすべてのパラメーターが暗号化され、復号化が試行されることを前提としています。powershell_param_\<script parameter name\> と powershell_\<script parameter name\> の間で適切なパラメーターを選択していることを確認してください。誤ったプリフィックスを使用すると、PowerShell の実行でエラーが発生します。これは、ECC キュー入力内のインスタンスに戻されます。 デフォルト：なし |
| debug | プローブ中のデバッグログ出力を有効にします。 デフォルト：false |
| credentials_debug | ECC キューに \<credentials_debug\> セクションを表示します。これは認証情報のトラブルシューティングに役立ちます。このプロパティを true に設定すると、認証情報に問題がない場合でも、認証情報のトラブルシューティング情報が ECC キューに出力されます。 デフォルト：false |
[ ]

{#c_PowershellProbe__table_thk_ngg_dcb}

## スクリプト要件 {#c_PowershellProbe__section_ayh_mfg_dcb}

カスタム PowerShell スクリプトは、任意の非ブーリアンコマンドラインパラメーターを渡すために環境変数を使用する必要があります。スクリプトの Param() 部の非ブーリアンパラメーターを、同じ名前のスクリプト変数に置き換えます。SNC_ のプリフィックスを持つ環境の一部としてスクリプト変数を定義します。したがって、次のような文字列パラメーターは、  

    Param([string]$paramName)

次のようなスクリプト変数になります。  

    if(test-path env:\SNC_paramName) {
        $paramName = $env:SNC_paramName
    }

たとえば、PSScript.ps1 スクリプトからのこのパラメーター定義には、スクリプト変数としての再定義が必要な複数の文字列パラメーターが含まれています。  

    Param([string]$computer, [string]$script, [string]$user, [string]$password, [boolean]$useCred, [boolean]$isDiscovery, [boolean]$debug)

非ブーリアンパラメーターをスクリプト変数として定義すると、次のようなスクリプトが生成されます。  

    Param([boolean]$useCred, [boolean]$isDiscovery, [boolean]$debug)
     
    # Copy the environment variables to the params
    if(test-path env:\SNC_computer) {
      $computer=$env:SNC_computer
    }
     
    if(test-path env:\SNC_script) {
      $script=$env:SNC_script
    }
     
    if(test-path env:\SNC_user) {
      $user=$env:SNC_user
      $password=$env:SNC_password
    }

* **[カスタム PowerShell プローブの作成](https://servicenow-prod.fluidtopics.net/rlOk3fsXplwxMbBh5_EfwQ)**   
  独自の PowerShell プローブを作成し、プローブパラメーターを設定することができます。