Komentosarjatoiminnot

Tärkeää

Luvattoman käytön estämiseksi Windows edellyttää järjestelmänvalvojan oikeuksia suojattujen resurssien käyttämiseen. Voit käyttää suojattuja resursseja (kuten tiedostoja) komentosarjatoimintoja käyttämällä suorittamalla Power Automate järjestelmänvalvojan oikeuksilla. Lisätietoja Power Automate suorittamisesta järjestelmänvalvojana on artikkelissa Power Automate suorittaminen korotein oikeuksin.

Komentosarjatoimintojen avulla voidaan suorittaa koodilohkoja ja toteuttaa mukautettua toimintaa työpöytätyönkuluissa.

Tärkeää

Kuten lokakuussa 2023 ilmoitettiin, Windows lakkauttaa VBScriptin. Windowsin tulevissa versioissa VBScript on käytettävissä tarvittaessa, ennen kuin se poistetaan käyttöjärjestelmästä. Lisätietoja on Vanhentuneiden ominaisuuksien resurssit -kohdassa.

Kaikki komentosarjatoiminnot noudattavat vastaavan ohjelmointi- tai komentosarjakielen perusrakennetta: PowerShell, Python, VBScript, JavaScript ja C#/VB.NET.

Muistiinpano

C#:ia tukeva versio: v 5.0. VB.NET:iä tukeva versio: v 11.0

Copilot tarjoama komentosarjojen luonnollinen kieli (esiversio)

[Tämä aihe sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Komentosarjan luonnollinen kieli on uusi Copilot -ominaisuus, joka lisätään desktop-Power Automate. Sen avulla voit nopeasti luoda komentosarjatoiminnoissa käytetyn koodin kuvailemalla sen luonnollisella kielellä. Tämä toiminto on saatavana seuraavissa komentosarjatoiminnoissa:

  • Suorita PowerShell
  • Suorita VBScript
  • Suorita DOS-komento
  • Pythonin suorittaminen
  • Suorita JavaScript

Tärkeää

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.
  • Lisätietoja on kohdassa esiversion ehdot.

Saatavuus alueittain

Tällä hetkellä luontevan komentosarjan kieli on käytettävissä seuraavilla alueilla sijaitsevissa ympäristöissä:

  • Tyynenmeren Aasia
  • Australia
  • Brasilia
  • Kanada
  • Eurooppa
  • Ranska
  • Saksa
  • Intia
  • Japani
  • Norja
  • Singapore
  • Etelä-Afrikka
  • Etelä-Korea
  • Ruotsi
  • Sveitsi
  • Yhdistyneet arabiemiirikunnat
  • Iso-Britannia
  • Yhdysvallat

Käytettävyys tilityypin mukaan

Tällä hetkellä Copilot desktop-Power Automate on käytettävissä vain käyttäjille, joilla on työpaikan tai oppilaitoksen tili.

Muistiinpano

Jos ympäristö kuuluu johonkin aiemmin mainittuun alueeseen ja haluat yhä nähdä avustajan Power Automate -työpöytäsovelluksen käyttökokemuksessa, ota yhteyttä vuokraajan järjestelmänvalvojaan.

Komentosarjojen luominen Copilot ja luonnollisella kielellä

Luo komentosarjoja vetämällä ja pudottamalla jokin tuetuista komentosarjatoiminnoista suunnittelutyökaluun ja valitsemalla sitten Luo komentosarja Copilot.

Näyttökaappaus suoritetusta PowerShell-toiminnosta, jossa Luo komentosarja Copilotilla -painikkeella on korostettuna

Näyttöön avautuu Luo kehote -näyttö, johon voit kirjoittaa luonnollisen kielen kehotteen.

Näyttökuva Luo PowerShell -toiminnosta, jossa kehoteikkuna on avoinna

Luo komentosarja kirjoittamalla kehote ja valitsemalla Luo. Jos sinun on luotava se uudelleen, muuta kehotetta ja valitse Luo uudelleen. Muussa tapauksessa valitse Käytä tätä komentosarjaa palataksesi päätoimintoikkunaan, jossa voit muokata sitä ja lisätä tarvittavia muuttujia.

Näyttökuva Käytä tätä komentosarjaa -PowerShell-toiminnosta, jossa kehoteikkuna on avoinna

Tärkeää

Tarkista aina tekoälymallin luoma sisältö.

Auta meitä parantamaan tätä ominaisuutta

Lähetä palautetta valitsemalla Peukalo ylös- tai Peukalo alas -kuvake tekoälyn luoman sisällön alta. Kun valitset kuvakkeen, näyttöön tulee palautevalintaikkuna, jonka avulla voit lähettää palautetta Microsoft. Animoitu gif, jossa avustaja vastaa suunnittelijan esittämään käyttäjän kysymykseen.

Muistiinpano

Jos et näe dialogia, vuokraajan järjestelmänvalvoja on saattanut poistaa sen käytöstä. Saat lisätietoja ohjeartikkelista Käyttäjän palautetoiminnon poistaminen käytöstä.

Käyttäjän palautetoiminnon poistaminen käytöstä

Power Platform -järjestelmänvalvojana voit estää käyttäjiä lähettämästä Copilot palautetta Microsoft vuokraajan "Copilot palaute" -asetuksella.

Rekisteröityjen oikeuksien pyynnöt käyttäjäpalautteen perusteella

Vuokraajan järjestelmänvalvojat voivat tarkastella, viedä ja poistaa käyttäjien palautetta Microsoft 365 -hallintakeskukseen ja valitsemalla sitten Kunto>Tuotepalaute.

Tekoäly ja Power Automate -resurssit

Työskentely muuttujien kanssa komentosarjatoiminnoissa

Jos haluat määrittää muuttujia komentosarjoissa ja palauttaa tuloksia Power Automatessa, käytä seuraavia komentoja:

  • Jos haluat määrittää uusia muuttujia PowerShell-komentosarjoissa, käytä $-kirjoitusta. Jos haluat palauttaa arvot Suorita PowerShell -komentosarjatoiminnot Power Automate -kohteeseen, käytä Kirjoita tulos -komentoa.

    $variableName = "variableValue"
Write-Output $variableName

  • Python-komentosarjat eivät vaadi erityisiä kirjoituksia uusien muuttujien ilmoittamiseen. Jos haluat palauttaa arvoja Suorita Python -komentosarja -toiminnoista, käytä tulostus-toimintoa.

    variableName = "variableValue"
print variableName

  • VBScript ei vaadi erityisiä kirjoituksia uusien muuttujien ilmoittamiseen. WScript.Echo -funktion avulla voit palauttaa arvot Run VBScript -toiminnoista Power Automateen.

    variableName = "variableValue"
WScript.Echo variableName

  • JavaScript-komentosarjoitusten avulla voit määrittää uusia muuttujia ja WScript.Echo-funktion avulla palauttaa arvoja Suorita JavaScript -toiminnoista.

    var variableName = "variableValue";
WScript.Echo(variableName);

  • Käytä .NET-komentosarjoja varten Komentosarjaparametrit-ikkunaa, johon pääset Suorita .Net-komentosarja -toiminnon määrityskortin kautta. Voit määrittää kulloisenkin muuttujan tyypin:

Näyttökuva Komentosarjan parametrit -ikkunasta Suorita .NET-komentosarja -toiminnossa, jossa määritetään muuttujan tyyppi

Lisäksi voit valita, onko kyseessä syöte .NET-komentosarjaan (Sisään-vaihtoehto avattavassa Suunta-valikossa), komentosarjan tulos (Ulos-vaihtoehto avattavassa Suunta-valikossa) vai kumpikin (Sisään-ulos-vaihtoehto avattavassa Suunta-valikossa).

Näyttökuva Komentosarjan parametrit -ikkunasta Suorita .NET-komentosarja -toiminnossa, jossa määritetään suunta

Jos haluat käyttää Power Automate -muuttujia komentosarjoissa, käytä prosenttilukua (%) ja käsittele muuttujia samalla tavalla kuin koodatut arvot.

Näyttökuva Python-komentosarjasta, joka sisältää prosenttiluvun.

Suorita DOS-komento

Suorittaa DOS-komento- tai konsolisovelluksen näkymättömässä tilassa ja palauttaa sen tulosteen, kun se on valmis.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
DOS-komento tai -sovellus Ei Tiedosto DOS-komennon tai konsolisovelluksen nimi. Sisällytä argumentit tarvittaessa.
Työkansio Kyllä Folder Se sisältää sen kansion koko polun, josta tiedot toimivat soveltuvissa tapauksissa.
Merkitse epäonnistuneeksi aikakatkaisun jälkeen Kyllä Totuusarvo Määritä, suoritetaanko DOS-komento tai sovellus määritetyn ajanjakson jälkeen loputtomasti vai epäonnistuuko se.
Timeout Ei Numeerinen arvo 10 Komentosarjan valmistumisen odotettavien sekuntien enimmäismäärä (-1 loputtomasti).
Koodisivun muuttaminen – Totuusarvo Epätosi Määrittää, muutetaanko istunnon nykyistä koodisivua.
Encoding Ei ASMO-708: arabia (ASMO 708), big5: kiina, perinteinen (Big5), cp1025: IBM EBCDIC (kyrillinen serbia ja bulgaria), cp866: kyrillinen (DOS), cp875: IBM EBCDIC (kreikka, moderni), csISO2022JP: japani (JIS, yksitavuinen Kana), DOS-720: arabia (DOS), DOS-862: heprea (DOS), EUC-CN: kiina, yksinkertaistettu (EUC), EUC-JP: japani (JIS 0208-1990 ja 0212-1990), euc-jp: japani (EUC), euc-kr: korea (EUC), GB18030: kiina, yksinkertaistettu (GB18030), gb2312: kiina, yksinkertaistettu (GB2312), hz-gb-2312: kiina, yksinkertaistettu (HZ), IBM-Thai: IBM EBCDIC (thai), IBM00858: OEM monikielinen Latin-I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (USA-Kanada-euro), IBM01141: IBM EBCDIC (Saksa-Euro), IBM01142: IBM EBCDIC (Tanska-Norja-euro), IBM01143: IBM EBCDIC (Suomi-Ruotsi-euro), IBM01144: IBM EBCDIC (Italia euro), IBM01145: IBM EBCDIC (Espanja-euro), IBM01146: IBM EBCDIC (Iso-Britannia-euro), IBM01147: IBM EBCDIC (Ranska-euro), IBM01148: IBM EBCDIC (kansainvälinen-euro), IBM01149: IBM EBCDIC (islanti-euro), IBM037: IBM EBCDIC (USA-Kanada), IBM1026: IBM EBCDIC (Turkki Latin-5), IBM273: IBM EBCDIC (Saksa), IBM277: IBM EBCDIC (Tanska-Norja), IBM278: IBM EBCDIC (Suomi-Ruotsi), IBM280: IBM EBCDIC (Italia), IBM284: IBM EBCDIC (Espanja), IBM285: IBM EBCDIC (Iso-Britannia), IBM290: IBM EBCDIC (japani, katakana), IBM297: IBM EBCDIC (Ranska), IBM420: IBM EBCDIC (arabia), IBM423: IBM EBCDIC (kreikka), IBM424: IBM EBCDIC (heprea), IBM437: OEM USA, IBM500: IBM EBCDIC (kansainvälinen), ibm737: kreikka (DOS), ibm775: balttilainen (DOS), ibm850: länsieurooppalainen (DOS), ibm852: keskieurooppalainen (DOS), IBM855: OEM kyrillinen, ibm857: turkki (DOS), IBM860: portugali (DOS), ibm861: islanti (DOS), IBM863: ranska, Kanada (DOS), IBM864: arabia (864), IBM865: pohjoismaalainen (DOS), ibm869: kreikka, moderni (DOS), IBM870: IBM EBCDIC (monikielinen Latin-2), IBM871: IBM EBCDIC (islanti), IBM880: IBM EBCDIC (kyrillinen venäjä), IBM905: IBM EBCDIC (turkki), iso-2022-jp: japani (JIS), iso-2022-jp: japani (JIS, yksitavuinen kana - SO/SI), iso-2022-kr: korea (ISO), iso-8859-1: länsieurooppalainen (ISO), iso-8859-13: viro (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: keskieurooppalainen (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: balttilainen (ISO), iso-8859-5: kyrillinen (ISO), iso-8859-6: arabia (ISO), iso-8859-7: kreikka (ISO), iso-8859-8: heprea (ISO-Visual), iso-8859-8-i: heprea (ISO-Logical), iso-8859-9: turkki (ISO), Johab: korea (Johab), koi8-r: kyrillinen (KOI8-R), koi8-u: kyrillinen (KOI8-U), ks_c_5601-1987: korea, macintosh: länsieurooppalainen (Mac), shift_jis: japani (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: keskieurooppalainen (Windows), windows-1251: kyrillinen (Windows), Windows-1252: länsieurooppalainen (Windows), windows-1253: kreikka (Windows), windows-1254: turkki (Windows), windows-1255: heprea (Windows), windows-1256: arabia (Windows), windows-1257: balttilainen (Windows), windows-1258: vietnam (Windows), windows-874: thai (Windows), x-Chinese-CNS: kiina, perinteinen (CNS), x-Chinese-Eten: kiina, perinteinen (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: kiina, yksinkertaistettu (GB2312-80), x-cp20949: korea, wansung, x-cp50227: kiina, yksinkertaistettu (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (korea, laajennettu), x-Europa: eurooppa, x-IA5: länsieurooppalainen (IA5), x-IA5-German: saksa (IA5), x-IA5-Norwegian: norja (IA5), x-IA5-Swedish: ruotsi (IA5), x-iscii-as: ISCII assami, x-iscii-be: ISCII bengali, x-iscii-de: ISCII devanagari, x-iscii-gu: ISCII gujarati, x-iscii-ka: ISCII kannada, x-iscii-ma: ISCII malajalam, x-iscii-or: ISCII orija, x-iscii-pa: ISCII punjabi, x-iscii-ta: ISCII tamil, x-iscii-te: ISCII telugu, x-mac-arabic: arabia (Mac), x-mac-ce: keskieurooppalainen (Mac), x-mac-chinesesimp: kiina, yksinkertaistettu (Mac), x-mac-chinesetrad: kiina, perinteinen (Mac), x-mac-croatian: kroatia (Mac), x-mac-cyrillic: kyrillinen (Mac), x-mac-greek: kreikka (Mac), x-mac-hebrew: heprea (Mac), x-mac-icelandic: islanti (Mac), x-mac-japanese: japani (Mac), x-mac-korean: korea (Mac), x-mac-romanian: romania (Mac), x-mac-thai: thai (Mac), x-mac-turkish: turkki (Mac), x-mac-ukrainian: ukraina (Mac)` utf-8: Unicode (UTF-8) Tulostetta lukiessa käytettävä koodaus.

Tuotetut muuttujat

Argumentti Type Description
CommandOutput Tekstiarvo Tekstituloste DOS-komennosta tai sovelluksesta.
CommandErrorOutput Tekstiarvo Teksti, joka kuvaa DOS-komennon tai -sovelluksen suorittamisen aikana tapahtuneita virheitä.
CommandExitCode Numeerinen arvo Komento tai sovelluksen lopetuskoodi. Tämä arvo on numeerinen.

Poikkeukset

Poikkeus Description
Komentoa tai konsolin sovellusta ei voi suorittaa Ilmaisee, että määritetyn komento- tai konsolisovelluksen suorittamisessa on ongelma.
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui Ilmaisee ongelman, joka ilmeni annetun komentosarjan suorittamisessa määritetyssä ajassa.

Suorita VBScript

Suorittaa mukautetun VBScript-koodin ja noutaa tuloksen muuttujaksi.

Tämän toiminnon avulla voit lisätä oman mukautetun VBScript-koodin työpöydän työnkulkuun. Voit luoda dynaamista VBScript-sisältöä komentosarjan muuttujien avulla.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
Suoritettava VBScript Kyllä Tekstiarvo Suoritettava VBScript-koodi. Sisällytä muuttujia komentosarjaan, koska ne arvioivat ennen VBScriptin suorittamista.
Merkitse epäonnistuneeksi aikakatkaisun jälkeen Kyllä Totuusarvo – Valitse, suoritetaanko VBScript ikuisesti vai päättyykö se määritetyn ajan kuluttua.
Timeout Ei Numeerinen arvo 10 Komentosarjan valmistumisen odotettavien sekuntien enimmäismäärä (-1 loputtomasti).

Tuotetut muuttujat

Argumentti Type Description
VBScriptOutput Tekstiarvo Komentosarjan tuloste.
ScriptError Tekstiarvo Kaikki virheet, jotka tapahtuvat, kun VBScript-koodia suoritetaan.

Poikkeukset

Poikkeus Description
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui Ilmaisee ongelman, joka ilmeni annetun komentosarjan suorittamisessa määritetyssä ajassa.

Suorita JavaScript

Suorittaa mukautetun JavaScript-koodin ja noutaa tuloksen muuttujaksi.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
JavaScript suoritettavaksi Kyllä Tekstiarvo Suoritettava JavaScript-komentosarjan koodi. Sisällytä muuttujia komentosarjaan, koska ne arvioivat ennen JavaScript-koodin suorittamista.
Merkitse epäonnistuneeksi aikakatkaisun jälkeen Kyllä Totuusarvo Määritä, suoritetaanko JavaScript-komentosarja loputtomasti vai epäonnistuuko se määritetyn ajanjakson jälkeen.
Timeout Ei Numeerinen arvo 10 Komentosarjan valmistumisen odotettavien sekuntien enimmäismäärä (-1 loputtomasti).

Tuotetut muuttujat

Argumentti Type Description
JavascriptOutput Tekstiarvo Komentosarjan tuloste.
ScriptError Tekstiarvo JavaScript-koodin suorituksen aikana ilmenevät virheet.

Poikkeukset

Poikkeus Description
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui Ilmaisee ongelman, joka ilmeni annetun komentosarjan suorittamisessa määritetyssä ajassa.

Suorita PowerShell-komentosarja

Suorittaa mukautetun PowerShell-komentosarjan ja noutaa sen tuloksen muuttujaksi.

Tämän toiminnon avulla voit sisällyttää omaan mukautettuun PowerShell-koodiin työpöydän työnkulkuun. Voit luoda dynaamista PowerShell-sisältöä muuttujien avulla.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
Suoritettava PowerShell-koodi Kyllä Tekstiarvo Suoritettava PowerShell-komentosarjan koodi. Sisällytä muuttujia komentosarjaan, koska ne arvioivat ennen PowerShell-koodin suorittamista
Merkitse epäonnistuneeksi aikakatkaisun jälkeen Kyllä Totuusarvo Määritä, suoritetaanko PowerShell-komentosarja loputtomasti vai epäonnistuuko se määritetyn ajanjakson jälkeen
Timeout Ei Numeerinen arvo 10 Komentosarjan valmistumisen odotettavien sekuntien enimmäismäärä (-1 loputtomasti).

Tuotetut muuttujat

Argumentti Type Description
PowershellOutput Tekstiarvo Komentosarjan tulos
ScriptError Tekstiarvo PowerShell-koodin suorituksen aikana ilmenevät virheet

Poikkeukset

Poikkeus Description
PowerShell-komentosarjan suorittaminen epäonnistui Osoittaa, että annetun PowerShell-komentosarjan suorittamisessa on ongelma
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui Ilmaisee ongelman, joka ilmeni annetun komentosarjan suorittamisessa määritetyssä ajassa.

Suorita Python-komentosarja

Suorittaa Python-komentosarjan koodin ja noutaa sen tulosteen.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
suoritettavan komentosarjan Python Ei Tekstiarvo Suoritettava Python-komentosarjan koodi
Python-versio Ei Python 2,7, Python 3,4 Python 2,7 Määritä, mitä Python-versiota käytetään komentosarjaa suoritettaessa
Moduulin kansiopolut Kyllä Luettelokansioista Niiden kansioiden polut, jotka sisältävät ulkoiset Python-moduulit

Tuotetut muuttujat

Argumentti Type Description
PythonScriptOutput Tekstiarvo Komentosarjan tulos
ScriptError Tekstiarvo Python komentosarjakoodin suorittamisen aikana ilmenevät virheet

Poikkeukset

Poikkeus Description
Python-komentosarjan suorittaminen epäonnistui Osoittaa, että annetun Python-komentosarjan suorittamisessa on ongelma
Hakemistoa ei löydy Osoittaa, että hakemistoa ei löytynyt

Suorita .NET-komentosarja

Suorittaa .NET (C#/VB.NET) -komentosarjan koodin ja noutaa sen tuloksen.

Syöteparametrit

Argumentti Valinnainen Hyväksyy Oletusarvo Description
Kieli – C#/ VB.NET C# Komentosarjan kieli
.NET-komentosarjan tuonnit Kyllä Tekstiarvo komentosarjaan sisällytettävät .NET komentosarjat
Viittaukset lataamiseen Kyllä Folder Pääpolku, jossa .NET dynaamisen linkkikirjaston (.dll) viittaukset sijaitsevat
Komentosarjan parametrit Kyllä Käyttäjän määrittämät komentosarjaparametrit Komentosarjassa määritettyjen parametrien arvojen määrittäminen
Suoritettava .NET-koodi Ei Tekstiarvo Suoritettava .NET-koodi

Tuotetut muuttujat

Tämä toiminto voi tuottaa muuttujia sen mukaan, mitä määrityksiä määritit Komentosarjaparametrit-ikkunassa .

Muistiinpano

Jos määrität toiminnon tulosparametrien tuottamiseksi ulkosuuntaa käyttämällä, varmista, että komentosarjan parametrin arvoksi on määritetty muu kuin tyhjäarvo. Muussa tapauksessa komentosarja palauttaa virheen, koska tulosteparametria ei ole määritetty.

Poikkeukset

Poikkeus Description
.NET-komentosarjan suoritus epäonnistui Osoittaa, että annetun .NET-komentosarjan suorittamisessa on ongelma
  • Viimeksi päivitetty