Del via


Scripthandlinger

Vigtigt

For at forhindre uautoriseret adgang kræver Windows administratorrettigheder til beskyttede ressourcer. Hvis du vil have adgang til beskyttede ressourcer (for eksempel filer) ved hjælp af scripthandlingerne, skal du køre Power Automate med administratorrettigheder. Du kan finde flere oplysninger om, hvordan du kører Power Automate som administrator, under Kør Power Automate med administratorrettigheder.

Scriptinghandlinger gør det muligt for brugerne at køre kodeblokke og implementere brugerdefineret adfærd i dine skrivebordsflows.

Vigtigt

Som annonceret i Oktober 2023 er VBScript udfaset fra Windows. I fremtidige versioner af Windows vil VBScript være tilgængelig som en funktion efter anmodning, før den fjernes fra operativsystemet. Du kan finde flere oplysninger under Ressourcer til udfasede funktioner.

Alle scripthandlinger følger den grundlæggende struktur i det pågældende programmerings- eller scriptsprog: PowerShell, Python, VBScript, JavaScript og C#/VB.NET.

Bemærk

Understøttet version for C#: v 5.0. For VB.NET: v 11.0

Naturligt sprog til script, der drives af copilot (forhåndsversion)

[Dette emne er en foreløbig udgivelse af dokumentationen, og der kan forekomme ændringer.]

Det naturlige sprog til kode er en ny copilot-funktion, vi har tilføjet i Power Automate til stationære computere. Du kan hurtigt oprette kode, der bruges i scripthandlingerne, ved at beskrive den. Denne funktion er tilgængelig i følgende scripthandlinger:

  • Kør PowerShell
  • Kør VBScript
  • Kør DOS-kommando
  • Kør Python
  • Kør JavaScript

Vigtigt

  • Dette er en forhåndsversion af funktionen.
  • Forhåndsversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.

Tilgængelighedsområder

På nuværende tidspunkt er copilot i Power Automate til stationære computere kun tilgængelig i miljøer i USA.

Tilgængelighed efter kontotype

I øjeblikket er copilot i Power Automate til stationære computere kun tilgængelig for brugere med en arbejds- eller skolekonto.

Bemærk

Hvis dit miljø er i det område, der er nævnt ovenfor, og du stadig har brug for at se copilot i Power Automate til desktop-oplevelsen, skal du kontakte din lejeradministrator. De har muligvis slået funktionen til copilot fra.

Sådan oprettes scripts ved hjælp af copilot og naturligt sprog

Hvis du vil oprette scripts i en af de understøttede scripthandlinger, skal du trække og slippe handlingen i designeren og vælge Genereret script med Copilot.

Skærmbillede af handlingen kør PowerShell med knappen Opret script med Copilot fremhævet

Skærmbilledet Opret prompt åbnes, hvor du kan skrive en prompt om det naturlige sprog.

Skærmbillede af handlingen til generering af PowerShell, hvor prompt-dialogboksen er åben

Hvis du vil oprette et script, skal du skrive prompten og vælge Opret. Hvis du har brug for at genoprette den, kan du ændre prompten og vælge Genopret. Ellers skal du vælge Brug dette script for at gå tilbage til hovedhandlingsvinduet, hvor du kan ændre det og tilføje eventuelle nødvendige variabler.

Skærmbillede af brug af dette script til PowerShell-handling, hvor prompt-dialogboksen er åben

Vigtigt

Sørg for, at du altid gennemser det indhold, der er genereret af AI-modellen.

Hjælp os med at forbedre denne funktion

Send feedback ved at vælge ikonet for pil op eller pil ned under det AI-genererede indhold. Når du har gjort det, vises der en dialogboks med feedback, som du kan bruge til at sende feedback til Microsoft. Gif-illustration, der viser, at medpiloten svarer på en brugers spørgsmål fra designeren.

Bemærk

Hvis du ikke kan se dialogboksen, har lejeradministratoren måske slået den fra. Flere oplysninger: Deaktivering af funktionaliteten for brugerfeedback

Deaktivering af funktionaliteten for brugerfeedback

Som lejeradministrator kan du forhindre dine brugere i at sende feedback til Microsoft ved at deaktivere disableSurveyFeedback-lejerindstilling. Du kan finde flere oplysninger om visning og indstilling af lejerindstillinger:

Anmodninger om data om emnerettigheder i brugerfeedback

Lejeradministratorer kan få vist, eksportere og slette feedback fra brugere ved at logge på Microsoft 365 Administration og derefter gå til Sundhed>Produkt-feedback.

AI med Power Automate-ressourcer

Arbejde med variabler i scripthandlinger

Hvis du vil erklære variabler i scripthandlinger og returnere resultater i Power Automate, skal du bruge følgende kommandoer:

  • Hvis du vil erklære nye variabler i PowerShell-scripts, skal du bruge $ som notation. Hvis du vil returnere værdier fra Kør PowerShell-script-handlinger til Power Automate, skal du bruge kommandoen Write-Output.

    $variableName = "variableValue"
    Write-Output $variableName
    
  • Python-scripts kræver ikke nogen særlig notation for at erklære nye variabler. Hvis du vil returnere værdier fra Kør Python-script-handlingerne, skal du bruge print-funktionen.

    variableName = "variableValue"
    print variableName
    
  • VBScript kræver ikke nogen særlig notation for at erklære nye variabler. Brug funktionen WScript.Echo til at returnere værdier fra Kør VBScript-handlinger til Power Automate.

    variableName = "variableValue"
    WScript.Echo variableName
    
  • I JavaScript-scripts skal du bruge notationen var til at erklære nye variabler og funktionen WScript.Echo til at returnere værdier fra Kør JavaScript-handlinger.

    var variableName = "variableValue";
    WScript.Echo(variableName);
    
  • I forbindelse med .NET-scripts skal du bruge vinduet Scriptparametre, der åbnes via konfigurationskortet for handlingen Kør .NET-script. Du kan angive typen af den pågældende variabel:

Skærmbillede af vinduet Scriptparametre i handlingen Kør .NET-script, hvor variabeltypen angives

Derudover kan du angive, om det er et input til .NET-scriptet (indstillingen Ind på rullelisten Retning), et output af scriptet (indstillingen Ud på rullelisten Retning) eller begge (indstilligenInd-Ud på rullelisten Retning).

Skærmbillede af vinduet Scriptparametre i handlingen Kør .NET-script, hvor retningen angives

Hvis du vil bruge Power Automate-variabler i scripthandlinger, skal du bruge procentnotationen (%) og håndtere variablerne på samme måde som hardcodede værdier.

Skærmbillede af et Python-script, der indeholder procentvis notation.

Kør DOS-kommando

Udfører en DOS-kommando eller et konsolprogram i usynlig tilstand og henter outputtet, når det er fuldført.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
DOS command or application Nej Filer Navnet på DOS-kommandoen eller et konsolprogram med argumenter, hvis det er relevant
Working folder Ja Mappe Den komplette sti til den mappe, som skal bruges, hvis den findes
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om DOS-kommandoen eller -applikationen skal køre uendeligt eller mislykkes efter en bestemt tidsperiode
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 for uendelig)
Skift kodeside I/R Boolesk værdi False Angiver, om sessionens aktuelle kodeside skal ændres
Encoding Nej ASMO-708: Arabisk (ASMO 708), big5: Kinesisk - traditionelt (Big5), cp1025: IBM EBCDIC (Kyrillisk serbisk-bulgarsk), cp866: Kyrillisk (DOS), cp875: IBM EBCDIC (Græsk, moderne), csISO2022JP: Japansk (JIS-Allow 1 byte Kana), DOS-720: Arabisk (DOS), DOS-862: Hebraisk (DOS), EUC-CN: Kinesisk, forenklet (EUC), EUC-JP: Japansk (JIS 0208-1990 og 0212-1990), euc-jp: Japansk (EUC), euc-kr: Koreansk (EUC), GB18030: Kinesisk, forenklet (GB18030), gb2312: Kinesisk, forenklet (GB2312), hz-gb-2312: Kinesisk, forenklet (HZ), IBM-Thai: IBM EBCDIC (Thai), IBM00858: OEM Flersprogligt latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (US-Canada-Euro), IBM01141: IBM EBCDIC (Tyskland-euro), IBM01142: IBM EBCDIC (Danmark-Norge-euro), IBM01143: IBM EBCDIC (Finland-Sverige-euro), IBM01144: IBM EBCDIC (Italien-Euro), IBM01145: IBM EBCDIC (Spanien-euro), IBM01146: IBM EBCDIC (Storbritannien-euro), IBM01147: IBM EBCDIC (Frankrig-euro), IBM01148: IBM EBCDIC (International-Euro), IBM01149: IBM EBCDIC (Island-euro), IBM037: IBM EBCDIC (USA-Canada), IBM1026: IBM EBCDIC (Tyrkisk latin-5), IBM273: IBM EBCDIC (Tyskland), IBM277: IBM EBCDIC (Danmark-Norge), IBM278: IBM EBCDIC (Finland-Sverige), IBM280: IBM EBCDIC (Italien), IBM284: IBM EBCDIC (Spanien), IBM285: IBM EBCDIC (Storbritannien), IBM290: IBM EBCDIC (Japansk katakana), IBM297: IBM EBCDIC (Frankrig), IBM420: IBM EBCDIC (Arabisk), IBM423: IBM EBCDIC (Græsk), IBM424: IBM EBCDIC (Hebraisk), IBM437: OEM USA, IBM500: IBM EBCDIC (International), ibm737: Græsk (DOS), ibm775: Baltisk (DOS), ibm850: Vesteuropæisk (DOS), ibm852: Centraleuropæisk (DOS), IBM855: OEM Kyrillisk, ibm857: Tyrkisk (DOS), IBM860: Portugisisk (DOS), ibm861: Islandsk (DOS), IBM863: Fransk canadisk (DOS), IBM864: Arabisk (864), IBM865: Nordisk (DOS), ibm869: Græsk, moderne (DOS), IBM870: IBM EBCDIC (Flersprogligt latin-2), IBM871: IBM EBCDIC (Islandsk), IBM880: IBM EBCDIC (Kyrillisk, russisk), IBM905: IBM EBCDIC (Tyrkisk), iso-2022-jp : Japansk (JIS), iso-2022-jp: Japansk (JIS-Allow 1 byte Kana - SO/SI), iso-2022-kr: Koreansk (ISO), iso-8859-1: Vesteuropæisk (ISO), iso-8859-13: Estisk (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: Centraleuropæisk (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: Baltisk (ISO), iso-8859-5: Kyrillisk (ISO), iso-8859-6: Arabisk (ISO), iso-8859-7 : Græsk (ISO), iso-8859-8: Hebraisk (ISO-Visual), iso-8859-8-i: Hebraisk (ISO-Logical), iso-8859-9: Tyrkisk (ISO), Johab: Koreansk (Johab), koi8-r: Kyrillisk (KOI8-R), koi8-u: Kyrillisk (KOI8-U), ks_c_5601-1987: Koreansk, macintosh: Vesteuropæisk (Mac), shift_jis: Japansk (Shift-JIS), us-ascii: US-ASCII, utf-16: Unicode, utf-16BE: Unicode (Big-Endian), utf-32: Unicode (UTF-32), utf-32BE: Unicode (UTF-32 Big-Endian), utf-7: Unicode (UTF-7), utf-8: Unicode (UTF-8), windows-1250: Central European (Windows), windows-1251: Cyrillic (Windows), Windows-1252: Western European (Windows), windows-1253: Greek (Windows), windows-1254: Turkish (Windows), windows-1255: Hebraisk (Windows), windows-1256: Arabisk (Windows), windows-1257: Baltisk (Windows), windows-1258: Vietnamesisk (Windows), windows-874: Thai (Windows), x-Chinese-CNS: Kinesisk, traditionelt (CNS), x-Chinese-Eten: Kinesisk, traditionelt (Eten), x-cp20001: TCA Taiwan, x-cp20003: IBM5550 Taiwan, x-cp20004: TeleText Taiwan, x-cp20005: Wang Taiwan, x-cp20261: T.61, x-cp20269: ISO-6937, x-cp20936: Chinese Simplified (GB2312-80), x-cp20949: Korean Wansung, x-cp50227: Chinese Simplified (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Koreansk, udvidet), x-Europa: Europa, x-IA5: Vesteuropæisk (IA5), x-IA5-German: Tysk (IA5), x-IA5-Norwegian: Norsk (IA5), x-IA5-Swedish: Svensk (IA5), x-iscii-as: ISCII Assamesisk, x-iscii-be: ISCII Bengalsk, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII Gujarati, x-iscii-ka: ISCII Kannada, x-iscii-ma: ISCII Malayalam, x-iscii-or: ISCII Oriya, x-iscii-pa: ISCII Punjabi, x-iscii-ta: ISCII Tamil, x-iscii-te: ISCII Telugu, x-mac-arabic: Arabisk (Mac), x-mac-ce: Centraleuropæisk (Mac), x-mac-chinesesimp: Kinesisk forenklet (Mac), x-mac-chinesetrad: Kinesisk, traditionelt (Mac), x-mac-croatian: Kroatisk (Mac), x-mac-cyrillic: Kyrillisk (Mac), x-mac-greek: Græsk (Mac), x-mac-hebrew: Hebraisk (Mac), x-mac-icelandic: Islandsk (Mac), x-mac-japanese: Japansk (Mac), x-mac-korean: Koreansk (Mac), x-mac-romanian: Rumænsk (Mac), x-mac-thai: Thai (Mac), x-mac-turkish: Tyrkisk (Mac), x-mac-ukrainian: Ukrainsk (Mac)` utf-8 : Unicode (UTF-8) Den kodning, der skal bruges til læsning af outputtet

Variabler produceret

Argument Type Beskrivelse
CommandOutput Tekstværdi Tekstoutputtet fra DOS-kommandoen eller -programmet
CommandErrorOutput Tekstværdi Den tekst, der beskriver de eventuelle fejl, der opstod under udførelsen af DOS-kommandoen eller -programmet
CommandExitCode Numerisk værdi Kommandoen eller programafslutningskode. Denne værdi er numerisk

Undtagelser

Undtagelse Beskrivelse
Kan ikke udføre kommando eller konsolprogram Angiver et problem med at udføre den angivne kommando eller konsolprogram
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script inden for den tildelte tid

Kør VBScript

Udfører en brugerdefineret VBScript-kode og henter outputtet til en variabel.

Du kan bruge denne handling til at inkludere din egen brugerdefinerede VBScript-kode i desktopflowet, samtidig med at du har mulighed for at bruge variabler deri, til at oprette dynamisk VBScript-indhold, hvis det er nødvendigt.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
VBScript to run Ja Tekstværdi VBScriptkode, der skal køres. Der kan være inkluderet variabler i scriptet, da de evalueres inden udførelse af VBScriptet
Mislykkedes efter timeout Ja Boolesk værdi I/R Angiv, om VBScript-scriptet skal køres uendeligt eller mislykkes efter en angivet tidsperiode
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 for uendelig)

Oprettede variabler

Argument Type Beskrivelse
VBScriptOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der kan forekomme under udførelse af VBScript-koden

Undtagelser

Undtagelse Beskrivelse
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script inden for den tildelte tid

Kør JavaScript

Udfører en brugerdefineret JavaScript-kode og henter outputtet til en variabel.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
JavaScript to run Ja Tekstværdi JavaScriptkode, der skal køres. Der kan være inkluderet variabler i scriptet, da de evalueres inden udførelse af JavaScriptet
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om JavaScript-scriptet skal køre uendeligt eller mislykkes efter en bestemt tidsperiode
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 for uendelig)

Oprettede variabler

Argument Type Beskrivelse
JavascriptOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der kan forekomme under udførelse af JavaScript-koden

Undtagelser

Undtagelse Beskrivelse
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script inden for den tildelte tid

Kør PowerShell-script

Udfører et brugerdefineret PowerShell-script og henter outputtet til en variabel.

Du kan bruge denne handling til at inkludere din egen brugerdefinerede PowerShell-kode i desktopflowet, samtidig med at du har mulighed for at bruge variabler deri, til at oprette dynamisk PowerShell-indhold, hvis det er nødvendigt.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
PowerShell code to run Ja Tekstværdi PowerShell, der skal køres. Der kan være inkluderet variabler i scriptet, da de evalueres inden udførelse af PowerShell-koden
Mislykkedes efter timeout Ja Boolesk værdi Angiv, om PowerShell-scriptet skal køres uendeligt eller mislykkes efter en bestemt tidsperiode
Timeout Nej Numerisk værdi 10 Det maksimale antal sekunder, der skal ventes på, at scriptet fuldføres (-1 for uendelig)

Oprettede variabler

Argument Type Beskrivelse
PowershellOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der kan forekomme under udførelse af PowerShell-koden

Undtagelser

Undtagelse Beskrivelse
Kunne ikke køre PowerShell-script Angiver et problem med at køre det angivne PowerShell-script
Scriptet kunne ikke køres inden for den tildelte tid Angiver et problem med at køre det angivne script inden for den tildelte tid

Kør Python-script

Udfører Python-scriptkode og henter outputtet.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
Python script to run Nej Tekstværdi Python-scriptkode, der skal køres
Python-version Nej Python 2.7, Python 3.4 Python 2.7 Angiv, hvilken version af Python der skal bruges ved udførelse af scriptet
Module folder paths Ja Liste over mapper Stierne til de mapper, hvor eksterne Python-moduler ligger

Variabler produceret

Argument Skriv Beskrivelse
PythonScriptOutput Tekstværdi Scriptets output
ScriptError Tekstværdi De fejl, der kan forekomme under udførelse af Python-scriptkoden

Undtagelser

Undtagelse Beskrivelse
Kunne ikke køre Python-script Angiver et problem med at køre det angivne Python-script
Mappen blev ikke fundet Angiver, at mappen ikke blev fundet

Kør .NET-script

Udfører .NET (C#/VB.NET)-scriptkode og henter outputtet.

Inputparametre

Argument Valgfrit Accepterer Standardværdi Beskrivelse
Sprog I/R C#/ VB.NET C# Scriptets sprog
.NET-script importerer Ja Tekstværdi Det .NET-script, der importeres, skal inkluderes i scriptet
Referencer, der skal indlæses Ja Mappe Den rodsti, hvor referencer til .NET-dynamiske linkbiblioteker (.dll filer) findes
Scriptparametre Ja Scriptparametre som defineret af brugeren Angivelse af værdierne for de parametre, der er defineret i scriptet
.NET-kode, der skal køres Nej Tekstværdi Den .NET-kode, der skal køres

Oprettede variabler

Denne handling kan oprette variabler, afhængigt af den konfiguration brugeren har foretaget i vinduet Scriptparametre.

Bemærk

Hvis handlingen er konfigureret til at oprette outputparametre (ved at bruge retningen Ud under konfigurationen), skal du altid sikre dig, at parameteren i scriptet er angivet til en anden værdi end null. Ellers resulterer udførelsen af scriptet i en fejl, da outputparameteren ikke er blevet angivet.

Undtagelser

Undtagelse Beskrivelse
.NET-scriptet kunne ikke køres Angiver et problem med at køre det angivne .NET-script