---
sourceDocument: Yokohama IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/it-operations-management

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# PowerShell-Probe

# PowerShell-Probe {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die PowerShell-Probe führt PowerShell V2-Skripts auf dem MID-Serverhost aus.
PowerShell-Skripts sind als Probe-Parameter mit dem Dateinamen als Parameternamen definiert. Es ist als Probe-Typ verfügbar, indem PowerShell als ECC-Warteschlangenthema der Probe angegeben wird.

## PowerShell-Probe-Parameter {#c_PowershellProbe__section_alf_pdg_dcb}

{#c_PowershellProbe__table_thk_ngg_dcb__entry__2}

| Parametername | Beschreibung |
|-|-|
| Quelle | \[Erforderlich\] der anfängliche Host, mit dem eine Verbindung hergestellt werden soll. Standard: Keine |
| \<script name\>.ps1 | \[Erforderlich\] der Dateiname des auszuführenden PowerShell-Skripts. Ersetzen \<script name\>Mit einem gültigen Dateinamenspräfix. Standard: Keine |
| powershell_command_parameter_passing | Gibt an, ob Skriptparameter an der Befehlszeile übergeben werden sollen. Unabhängig vom Wert dieses Parameters, ServiceNowMacht alle Skriptparameter in der Befehlszeile automatisch für PowerShell-Skripts als Umgebungsvariablen verfügbar. Standard: Falsch |
| powershell_Parameter_\<script parameter name\> | Übergibt zusätzliche Parameter an das auszuführende PowerShell-Skript. Jeder Parameter wird dem Skript als Umgebungsvariable im Format angezeigt $env:SNC_\<script parameter name\>. Parameter mit diesem Präfix gelten nicht als verschlüsselt und werden unberührt an das Skript übergeben. Stellen Sie sicher, dass Sie den entsprechenden Parameter zwischen auswählen powershell_param_\<script parameter name\>Und powershell_\<script parameter name\>. Die Verwendung des falschen Präfixes führt zu Fehlern bei der PowerShell-Ausführung, die in der ECC-Warteschlangeneingabe an die Instanz zurückgegeben wird. Standard: Keine |
| powershell_\<script parameter name\> | Übergibt zusätzliche Parameter an das auszuführende PowerShell-Skript. Jeder Parameter wird dem Skript als Umgebungsvariable im Format angezeigt $env:SNC_\<script parameter name\>. Der MID-Server geht davon aus, dass ein Parameter mit diesem Präfix verschlüsselt ist, und versucht, ihn zu entschlüsseln. Stellen Sie sicher, dass Sie den entsprechenden Parameter zwischen auswählen powershell_param_\<script parameter name\>Und powershell_\<script parameter name\>. Die Verwendung des falschen Präfixes führt zu Fehlern bei der PowerShell-Ausführung, die in der ECC-Warteschlangeneingabe an die Instanz zurückgegeben wird Standard: Keine |
| debug | Aktiviert die Debug-Protokollausgabe während der Probe. Standard: Falsch |
| Anmeldeinformationen_Debug | Zeigt einen \<credentials_debug\>-Abschnitt in der ECC-Warteschlange an, der Ihnen bei der Problembehandlung von Anmeldeinformationen helfen kann. Wenn Sie diese Eigenschaft auf „wahr" festlegen, werden Informationen zur Fehlerbehebung bei Anmeldeinformationen an die ECC-Warteschlange ausgegeben, auch wenn die Anmeldeinformationen erfolgreich sind. Standard: Falsch |
[ ]

{#c_PowershellProbe__table_thk_ngg_dcb}

## Skripting-Anforderungen {#c_PowershellProbe__section_ayh_mfg_dcb}

Alle anwenderdefinierten PowerShell-Skripts müssen Umgebungsvariablen verwenden, um nicht-boolesche Befehlszeilenparameter zu übergeben. Ersetzen Sie nicht boolesche Parameter in Parameter() Teil des Skripts mit Skriptvariablen desselben Namens. Definieren Sie die Skriptvariable als Teil der Umgebung mit einem SNC_-Präfix. Also ein Zeichenfolgenparameter wie dieser:  

    Param([string]$paramName)

Wird zu einer Skriptvariablen wie der folgenden:  

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

Diese Parameterdefinition aus dem Skript „PSScript.ps1" enthält beispielsweise mehrere Zeichenfolgenparameter, die als Skriptvariablen neu definiert werden müssen:  

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

Das Definieren der nicht booleschen Parameter als Skriptvariablen würde zu diesem Skripttyp führen:  

    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
    }

* **[Erstellen Sie eine anwenderdefinierte PowerShell-Probe](https://servicenow-prod.fluidtopics.net/y6WogC8DXE8_Vnf2PdQd8A)**   
  Sie können eine eigene PowerShell-Probe erstellen und Probe-Parameter konfigurieren.