Skripthandlinger

Viktig

Hvis du vil hindre uautorisert tilgang, krever Windows administratorrettigheter for å få tilgang til beskyttede ressurser. Hvis du vil ha tilgang til beskyttede ressurser (for eksempel filer) ved hjelp av skripthandlingene, kjører du Power Automate med administratorrettigheter. Hvis du vil ha mer informasjon om hvordan du kjører Power Automate som administrator, kan du se Kjøre Power Automate med utvidede rettigheter.

Skripthandlingene gjør det mulig for deg å kjøre kodeblokker og implementere tilpasset virkemåte i skrivebordsflytene.

Viktig

Som annonsert i oktober 2023, avskriver Windows VBScript. I fremtidige versjoner av Windows vil VBScript være tilgjengelig som en funksjon ved behov før den fjernes fra operativsystemet. Hvis du vil ha mer informasjon, kan du se Ressurser for avskrevne funksjoner.

Alle skripthandlinger følger den grunnleggende strukturen i det respektive programmerings- eller skriptspråket: PowerShell, Python, JavaScript og C#/VB.NET.

Notat

Støttet versjon for C#: v 5.0. For VB.NET: v 11.0

Naturlig språk for skript drevet av Copilot (forhåndsversjon)

[Dette emnet inneholder dokumentasjon for forhåndsversjonen, og kan bli endret.]

Naturlig språk for skript er en ny Copilot funksjonalitet som legges til i Power Automate for skrivebordet. Den lar deg raskt generere koden som brukes i skripthandlingene ved å beskrive den på naturlig språk. Denne funksjonen er ikke tilgjengelig i følgende skripthandlinger:

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

Viktig

  • Dette er forhåndsversjonsfunksjon.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.
  • Hvis du vil ha mer informasjon, kan du gå til betingelser for forhåndsversjon.

Tilgjengelighet etter område

Naturlig språk for skript er for øyeblikket tilgjengelig i miljøer i følgende områder:

  • Asia/Stillehavskysten
  • Australia
  • Brasil
  • Canada
  • Europa
  • Frankrike
  • Tyskland
  • India
  • Japan
  • Norge
  • Singapore
  • Sør-Afrika
  • Sør-Korea
  • Sverige
  • Sveits
  • De forente arabiske emirater
  • Storbritannia
  • USA

Tilgjengelighet etter kontotype

For øyeblikket er Copilot i Power Automate for skrivebord bare tilgjengelig for brukere med en jobb- eller skolekonto.

Notat

Hvis miljøet er i et av de tidligere oppførte områdene og du likevel må kunne se kopiloten i Power Automate for skrivebord, kontakter du leieradministratoren.

Slik genererer du skript ved hjelp av Copilot og naturlig språk

Hvis du vil generere skript, drar og slipper du en av de støttede skripthandlingene til utformeren, og deretter velger du Generer skript med Copilot.

Skjermbilde av Kjør PowerShell-handlingen med Generer skript med Copilot-knappen uthevet

Skjermbildet Opprett ledetekst åpnes der du kan skrive inn ledeteksten for naturlig språk.

Skjermbilde av generer PowerShell-handlingen med ledetekstdialogboksen åpen

Hvis du vil opprette et skript, skriver du ledeteksten og velger Generer. Hvis du trenger å opprette den på nytt, endrer du ledeteksten og velger Lag på nytt. Ellers velger du Bruk dette skriptet til å gå tilbake til hovedhandlingsvinduet, der du kan endre det og legge til eventuelle nødvendige variabler.

Skjermbilde av Bruk dette skriptet PowerShell-handlingen med ledetekstdialogboksen åpen

Viktig

Se alltid gjennom innholdet som genereres av AI-modellen.

Hjelp oss med å forbedre denne funksjonen

Send tilbakemelding ved å velge tommel opp eller tommel ned-ikonet under ai-generert innhold. Når du velger et ikon, vises en dialogboks for tilbakemelding som du kan bruke til å sende inn tilbakemelding til Microsoft. Animert GIF som viser kopilot som svarer på en brukers spørsmål fra utformingen.

Notat

Hvis du ikke ser dialogen, kan det hende at leieradministratoren har deaktivert den. Hvis du vil ha mer informasjon, kan du se Deaktivere brukertilbakemeldingsfunksjonaliteten.

Deaktiver funksjonalitet for tilbakemelding fra brukere

Som power platform-administrator kan du hindre brukere i å sende Copilot tilbakemelding til Microsoft ved hjelp av leierinnstillingen «Copilot tilbakemelding».

Forespørsler fra de registrerte om brukertilbakemelding

Leieradministratorer kan vise, eksportere og slette tilbakemeldinger fra brukerne ved å logge seg på administrasjonssenteret for Microsoft 365 og deretter velge Tilstand>Produkttilbakemelding.

Kunstig intelligens med Power Automate-ressurser

Arbeid med variabler i skripthandlinger

Bruk følgende kommandoer for å erklære variabler i skripthandlinger og returnere resultater i Power Automate:

  • Hvis du vil erklære nye variabler i PowerShell-skript, bruker du $-notasjonen. For å returnere verdier fra Kjør PowerShell-skript-handlinger til Power Automate, bruker du kommandoen Write-Output.

    $variableName = "variableValue"
    Write-Output $variableName
    
  • Python/skript krever ingen spesiell notasjon for å erklære nye variabler. For å returnere verdier fra Kjør Python-skript-handlinger bruker du skriv-funksjonen.

    variableName = "variableValue"
    print variableName
    
  • VBScript krever ingen spesiell notasjon for å erklære nye variabler. Bruk funksjonen WScript.Echo til å returnere verdier fra Kjør VBScript-handlinger til Power Automate.

    variableName = "variableValue"
    WScript.Echo variableName
    
  • I JavaScript-skript bruker du var-notasjonen til å erklære nye variabler og funksjonen WScript.Echo til å returnere verdier fra Kjør JavaScript-handlinger.

    var variableName = "variableValue";
    WScript.Echo(variableName);
    
  • Bruk vinduet Skriptparametere for .NET-skript. Du får tilgang til vinduet via konfigurasjonskortet for handlingen Kjør .NET-skript. Du kan angi typen for den respektive variabelen:

Skjermbilde av vinduet Skriptparametere i handlingen Kjør .NET-skript, der variabeltypen angis

Du kan i tillegg angi om det er inndata til .NET-skriptet (alternativet Inn i rullegardinlisten Retning), utdata fra skriptet (alternativet Ut i rullegardinlisten Retning) eller begge deler (alternativet Inn-Ut i rullegardinlisten Retning).

Skjermbilde av vinduet Skriptparametere i handlingen Kjør .NET-skript, der retningen angis

Hvis du vil bruke Power Automate-variabler i skripthandlinger, bruker du prosentnotasjonen (%) og håndterer variablene på samme måte som hardkodede verdier.

Skjermbilde av et Python-skript som inneholder den prosentvise notasjonen.

Kjør DOS-kommando

Kjører en DOS-kommando eller konsollprogram i usynlig modus og returnerer utdataene når det er ferdig.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
DOS-kommando eller -program Nei Fil Navnet på DOS-kommandoen eller et konsollprogram. Inkluder argumenter om nødvendig.
Arbeidsmappe Ja Mappe Den fullstendige banen til mappen du vil arbeide fra, hvis aktuelt.
Feil etter tidsavbrudd Ja Boolsk verdi Angi om DOS-kommandoen eller -programmet kjører på ubestemt tid eller mislykkes etter en angitt tidsperiode.
Timeout Nei Numerisk verdi 10 Maksimalt antall sekunder å vente på at skriptet skal fullføres (-1 for ubestemt tid).
Endre tegntabell Ikke tilgjengelig Boolsk verdi False Angir om øktens gjeldende tegntabell skal endres.
Encoding Nei ASMO-708: arabisk (ASMO 708), big5: kinesisk (tradisjonell) (Big5), cp1025: IBM EBCDIC (kyrillisk serbisk-bulgarsk), cp866: kyrillisk (DOS), cp875: IBM EBCDIC (gresk, 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 flerspråklig, Latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (USA-Canada-europeisk), IBM01141: IBM EBCDIC (tysk-europeisk), IBM01142: IBM EBCDIC (Danmark-Norge-europeisk), IBM01143: IBM EBCDIC (Finland-Sverige-europeisk), IBM01144: IBM EBCDIC (Italia-europeisk), IBM01145: IBM EBCDIC (Spania-europeisk), IBM01146: IBM EBCDIC (Storbritannia-europeisk), IBM01147: IBM EBCDIC (Frankrike-europeisk), IBM01148: IBM EBCDIC (Internasjonal-europeisk), IBM01149: IBM EBCDIC (Island-europeisk), 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 (Italia), IBM284: IBM EBCDIC (Spania), IBM285: IBM EBCDIC (Storbritannia), IBM290: IBM EBCDIC (japansk, katakana), IBM297: IBM EBCDIC (Frankrike), IBM420: IBM EBCDIC (arabisk), IBM423: IBM EBCDIC (gresk), IBM424: IBM EBCDIC (hebraisk), IBM437: OEM, USA, IBM500: IBM EBCDIC (internasjonal), ibm737: gresk (DOS), ibm775: baltisk (DOS), ibm850: vesteuropeisk (DOS), ibm852: sentraleuropeisk (DOS), IBM855: OEM, kyrillisk, ibm857: tyrkisk (DOS), IBM860: portugisisk (DOS), ibm861: islandsk (DOS), IBM863: fransk (Canada) (DOS), IBM864: arabisk (864), IBM865: nordisk (DOS), ibm869: gresk, moderne (DOS), IBM870: IBM EBCDIC (flerspråklig, 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: vesteuropeisk (ISO), iso-8859-13: estisk (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: sentraleuropeisk (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: gresk (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: vesteuropeisk (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: sentraleuropeisk (Windows), windows-1251: kyrillisk (Windows), Windows-1252: vesteuropeisk (Windows), windows-1253: gresk (Windows), windows-1254: tyrkisk (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 (tradisjonell) (CNS), x-Chinese-Eten: kinesisk (tradisjonell) (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: kinesisk (forenklet) (GB2312-80), x-cp20949: koreansk, Wansung, x-cp50227: kinesisk (forenklet) (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (koreansk, utvidet), x-Europa: Europa, x-IA5: vesteuropeisk (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, bengali, x-iscii-de: ISCII, devanagari, x-iscii-gu: ISCII, gujarati, x-iscii-ka: ISCII, kannada, x-iscii-ma: ISCII, malayalam, x-iscii-or: ISCII, odia, x-iscii-pa: ISCII, panjabi, x-iscii-ta: ISCII, tamil, x-iscii-te: ISCII, telugu, x-mac-arabic: arabisk (Mac), x-mac-ce: sentraleuropeisk (Mac), x-mac-chinesesimp: kinesisk (forenklet) (Mac), x-mac-chinesetrad: kinesisk (tradisjonell) (Mac), x-mac-croatian: kroatisk (Mac), x-mac-cyrillic: kyrillisk (Mac), x-mac-greek: gresk (Mac), x-mac-hebrew: hebraisk (Mac), x-mac-icelandic: islandsk (Mac), x-mac-japanese: japansk (Mac), x-mac-korean: koreansk (Mac), x-mac-romanian: rumensk (Mac), x-mac-thai: thai (Mac), x-mac-turkish: tyrkisk (Mac), x-mac-ukrainian: ukrainsk (Mac)` utf-8 : Unicode (UTF-8) Kodingen som skal brukes når du leser utdataene.

Variabler produsert

Argument Type Bekrivelse
CommandOutput Tekstverdi Tekstutdataene fra DOS-kommandoen eller -programmet.
CommandErrorOutput Tekstverdi Teksten som beskriver eventuelle feil som oppstod under kjøringen av DOS-kommandoen eller -programmet.
CommandExitCode Numerisk verdi Kommandoen eller programmets avslutningskode. Denne verdien er numerisk.

Unntak

Unntak Bekrivelse
Kan ikke kjøre kommando eller konsollprogram Angir et problem under kjøring av den angitte kommandoen eller konsollprogrammet.
Kan ikke kjøre skript på den tildelte tiden Angir et problem under kjøring av det angitte skriptet i den tildelte tiden.

Kjør VBScript

Kjører egendefinert VBScript-kode og henter utdataene til en variabel.

Bruk denne handlingen til å legge til din egen egendefinerte VBScript-kode i skrivebordsflyten. Du kan bruke variabler i skriptet til å opprette dynamisk VBScript-innhold.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
VBScript som skal kjøres Ja Tekstverdi VBScript-koden som skal kjøres. Inkluder variabler i skriptet fordi de evaluerer før VBScript kjører.
Feil etter tidsavbrudd Ja Boolsk verdi Ikke tilgjengelig Velg om VBScript kjører for alltid eller stopper etter en angitt tid.
Timeout Nei Numerisk verdi 10 Maksimalt antall sekunder å vente på at skriptet skal fullføres (-1 for ubestemt tid).

Variabler produsert

Argument Type Bekrivelse
VBScriptOutput Tekstverdi Skriptets utdata.
ScriptError Tekstverdi Eventuelle feil som oppstår når du kjører VBScript-koden.

Unntak

Unntak Bekrivelse
Kan ikke kjøre skript på den tildelte tiden Angir et problem under kjøring av det angitte skriptet i den tildelte tiden.

Kjør JavaScript

Kjører egendefinert JavaScript-kode og henter utdataene til en variabel.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
JavaScript som skal kjøres Ja Tekstverdi JavaScript-koden som skal kjøres. Inkluder variabler i skriptet fordi de evaluerer før JavaScript-koden kjøres.
Feil etter tidsavbrudd Ja Boolsk verdi Angi om JavaScript-skriptet kjører på ubestemt tid eller mislykkes etter en angitt tidsperiode.
Timeout Nei Numerisk verdi 10 Maksimalt antall sekunder å vente på at skriptet skal fullføres (-1 for ubestemt tid).

Variabler produsert

Argument Type Bekrivelse
JavascriptOutput Tekstverdi Skriptets utdata.
ScriptError Tekstverdi Feilene som oppstår under kjøringen av JavaScript-koden.

Unntak

Unntak Bekrivelse
Kan ikke kjøre skript på den tildelte tiden Angir et problem under kjøring av det angitte skriptet i den tildelte tiden.

Kjør PowerShell-skript

Utfører et egendefinert PowerShell-skript og henter utdataene til en variabel.

Bruk denne handlingen til å inkludere din egen egendefinerte PowerShell-kode i skrivebordsflyten. Du kan bruke variabler til å generere dynamisk PowerShell-innhold.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
PowerShell-kode som skal kjøres Ja Tekstverdi PowerShell-koden som skal kjøres. Inkluder variabler i skriptet siden de evaluerer før kjøringen av PowerShell-koden
Feil etter tidsavbrudd Ja Boolsk verdi Angi om PowerShell-skriptet kjører på ubestemt tid eller mislykkes etter en angitt tidsperiode
Timeout Nei Numerisk verdi 10 Maksimalt antall sekunder å vente på at skriptet skal fullføres (-1 for ubestemt tid).

Variabler produsert

Argument Type Bekrivelse
PowershellOutput Tekstverdi Skriptets utdata
ScriptError Tekstverdi Feilene som oppstår under kjøringen av PowerShell-koden

Unntak

Unntak Bekrivelse
Kan ikke kjøre PowerShell-skriptet Angir problemer ved kjøring av det angitte PowerShell-skriptet
Kan ikke kjøre skript på den tildelte tiden Angir et problem under kjøring av det angitte skriptet i den tildelte tiden.

Kjør Python-skript

Kjører Python-skriptkode og henter utdataene.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
Python skript som skal kjøres Nei Tekstverdi Python-skriptkoden som skal kjøres
Python-versjon Nei Python 2.7, Python 3.4 Python 2.7 Angi hvilken versjon av Python som skal brukes ved kjøring av skriptet
Modulmappebaner Ja Liste over mapper Banene til mapper der eksterne Python-moduler ligger

Variabler produsert

Argument Type Bekrivelse
PythonScriptOutput Tekstverdi Skriptets utdata
ScriptError Tekstverdi Feilene som oppstår under kjøringen av Python skriptkode

Unntak

Unntak Bekrivelse
Kan ikke kjøre Python-skriptet Angir problemer ved kjøring av det angitte Python-skriptet
Finner ikke katalogen Angir at katalogen ikke finnes

Kjør .NET-skript

Kjører .NET-skriptkode (C#/VB.NET) og henter utdataene.

Inndataparametere

Argument Valgfritt Godtar Standardverdi Bekrivelse
Språk Ikke tilgjengelig C#/VB.NET C# Språket i skriptet
.NET-skriptimporter Ja Tekstverdi Skriptet .NET som skal inkluderes i skriptet
Referanser som skal lastes inn Ja Mappe Rotbanen der .NET dynamiske koblingsbibliotek (.dll) referanser er plassert
Skriptparametere Ja Skriptparametere som definert av brukeren Angi verdiene for parameterne som er definert i skriptet
.NET-koden som skal kjøres Nei Tekstverdi .NET-koden som skal kjøres

Variabler produsert

Denne handlingen kan produsere variabler, avhengig av konfigurasjonen du angir i vinduet Skriptparametere .

Notat

Hvis du konfigurerer handlingen til å produsere utdataparametere ved hjelp av Ut-retningen , må du kontrollere at parameteren i skriptet er satt til en annen verdi enn null. Ellers returnerer skriptet en feil fordi utdataparameteren ikke er angitt.

Unntak

Unntak Bekrivelse
Kan ikke kjøre .NET-skriptet Angir problemer ved kjøring av det angitte .NET-skriptet