Komentosarjatoiminnot

Tärkeää

Luvattoman käytön estämiseksi Windows vaatii järjestelmänvalvojan oikeudet suojattujen resurssien käyttöön. Voit käyttää suojattuja resursseja (kuten tiedostoja) komentosarjatoimintojen avulla suorittamalla Power Automaten järjestelmänvalvojan oikeuksilla. Lisätietoja Power Automaten suorittamisesta järjestelmänvalvojana on kohdassa Power Automaten suorittaminen järjestelmänvalvojan oikeuksin.

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

Tärkeää

Kuten vuoden 2023 lokakuussa ilmoitettiin, Windowsin VBScript vanhenee. 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

Luonnollinen kieli skriptille, joka toimii avustajan avulla (esiversio)

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

Luonnollinen kieli koodille on uusi avustajaominaisuus, joka on lisätty Power Automate -työpöytäsovellukseen. Sen avulla voit nopeasti luoda komentosarjoissa käytettävää koodia kuvaamalla sitä. Tämä toiminto on saatavana seuraavissa komentosarjatoiminnoissa:

• Suorita PowerShell
• Suorita VBScript
• Suorita DOS-komento
• Suorita Python
• 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.

Saatavuus alueittain

Tällä hetkellä avustaja Power Automate -pöytäkonesovelluksessa on käytettävissä vain Yhdysvalloissa sijaitsevissa ympäristöissä.

Käytettävyys tilityypin mukaan

Tällä hetkellä avustaja Power Automate -työpöytäsovellukselle on saatavana vain käyttäjille, joilla on työ- tai koulutili.

Muistiinpano

Jos ympäristösi on edellä mainitulla alueella ja sinun on silti nähtävä avustaja Power Automate -työpöytäsovelluksen käyttökokemusta varten, ota yhteyttä vuokraajan järjestelmänvalvojaan. He ovat ehkä poistaneen avustajatoiminnon käytöstä.

Komentosarjojen muodostaminen avustajan ja luonnollisen kielen avulla

Jos haluat luoda komentosarjoja jollakin tuetuista komentosarjoista, vedä ja pudota toiminto suunnitteluohjelmassa ja valitse Luo skripti Copilotilla.

Näyttöön tulee luonnin kehotenäyttö, johon voit kirjoittaa luonnollisen kielikehotteen.

Luo komentosarja kirjoittamalla kehote ja valitsemalla Luo. Jos haluat luoda sen uudelleen, voit muuttaa kehotetta ja valita Luo uudelleen. Muussa tapauksessa voit palata päätoimintoikkunaan valitsemalla Käytä tätä komentosarjaa, jossa voit muokata sitä ja lisätä tarvittavia muuttujia.

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 alapuolelta. Sen jälkeen näyttöön tulee palauteikkuna, jonka avulla voit lähettää palautetta Microsoftille.

Muistiinpano

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

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

Vuokraajan järjestelmänvalvojana voit estää käyttäjiä lähettämästä palautetta Microsoftille poistamalla disableSurveyFeedback-vuokraajan asetuksen käytöstä. Lisätietoja vuokraajan asetusten tarkastelemiseen ja määrittämiseen:

• Vuokraajan asetusten luettelon näyttäminen (esiversio)
• Aseta TenantSettings

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

• Usein kysytyt kysymykset komentosarjojen luomisesta luonnollisella kielellä
• Power Automaten vastuullisen tekoälyn usein kysytyt kysymykset
• Copilotin tietoturvaa ja tietosuojaa Microsoft Power Platformissa koskevat usein kysytyt kysymykset

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:

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).

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

Suorita DOS-komento

Suorittaa DOS-komennon tai konsolin sovelluksen näkymättömässä tilassa ja noutaa sen tuloksen valmistumisen yhteydessä.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
DOS command or application	Ei	Tiedosto		DOS-komennon tai konsolin sovelluksen nimi ja argumentit, jos ne ovat saatavana
Working folder	Kyllä	Kansio		Kansion koko polku, jos se on saatavana
Merkitse epäonnistuneeksi aikakatkaisun jälkeen	Kyllä	Totuusarvo		Määritä, suoritetaanko DOS-komentoa tai sovellusta ikuisesti vai epäonnistuuko se tietyn ajan kuluttua
Timeout	Ei	Numeerinen arvo	10	Enimmäismäärä sekunteja, joiden kuluttua komentosarja valmistuu (-1 jatkuu loputtomasti)
Change code page	–	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)	Tulosteen lukemisessa käytettävä koodaus

Tuotetut muuttujat

Argumentti	Type	Description
CommandOutput	Tekstiarvo	DOS-komennon tai sovelluksen tekstitulos
CommandErrorOutput	Tekstin arvo	DOS-komennon tai sovelluksen suorituksen aikana tapahtuneet mahdolliset virheet kuvaava teksti
CommandExitCode	Numeerinen arvo	Komento tai sovelluksen lopetuskoodi. Tämä arvo on numeerinen

Poikkeukset

Poikkeus	Description
Komentoa tai konsolin sovellusta ei voi suorittaa	Osoittaa, että määritetyn komennon tai konsolin sovelluksen suorittamisessa on ongelma
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui	Ilmaisee ongelman suoritettaessa annettua komentosarjaa määritetyssä ajassa

Suorita VBScript

Suorittaa mukautettua VBScript-koodia ja hakee sen tuloksen muuttujaan.

Voit käyttää tätä toimintoa lisätäksesi omaa mukautettua VBScript-koodiasi työpöytätyönkulkuun ja käyttääksesi siinä samalla muuttujia, jotta voit luoda dynaamista VBScript-sisältöä tarvittaessa.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
VBScript to run	Kyllä	Tekstin arvo		Suoritettava VBScript-komentosarjan koodi. Muuttujat voidaan sisällyttää komentosarjaan, koska ne arvioidaan ennen VBScript-koodin suorittamista
Merkitse epäonnistuneeksi aikakatkaisun jälkeen	Kyllä	Totuusarvo	–	Määritä, suoritetaanko VBScript-komentosarja pysyvästi vai epäonnistuuko se tietyn ajan kuluttua
Timeout	Ei	Numeerinen arvo	10	Enimmäismäärä sekunteja, joiden kuluttua komentosarja valmistuu (-1 jatkuu loputtomasti)

Tuotetut muuttujat

Argumentti	Type	Description
VBScriptOutput	Tekstiarvo	Komentosarjan tulos
ScriptError	Tekstin arvo	VBScript-koodin suorittamisen aikaiset mahdolliset virheet

Poikkeukset

Poikkeus	Description
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui	Ilmaisee ongelman suoritettaessa annettua komentosarjaa määritetyssä ajassa

Suorita JavaScript

Suorittaa mukautettua JavaScript-koodia ja hakee sen tuloksen muuttujaan.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
JavaScript to run	Kyllä	Tekstin arvo		Suoritettava JavaScript-komentosarjan koodi. Muuttujat voidaan sisällyttää komentosarjaan, koska ne arvioidaan ennen JavaScript-koodin suorittamista
Merkitse epäonnistuneeksi aikakatkaisun jälkeen	Kyllä	Totuusarvo		Määritä, suoritetaanko Javascript-komentosarjaa ikuisesti vai epäonnistuuko se tietyn ajan kuluttua
Timeout	Ei	Numeerinen arvo	10	Enimmäismäärä sekunteja, joiden kuluttua komentosarja valmistuu (-1 jatkuu loputtomasti)

Tuotetut muuttujat

Argumentti	Type	Description
JavascriptOutput	Tekstiarvo	Komentosarjan tulos
ScriptError	Tekstin arvo	JavaScript-koodin suorittamisen aikaiset mahdolliset virheet

Poikkeukset

Poikkeus	Description
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui	Ilmaisee ongelman suoritettaessa annettua komentosarjaa määritetyssä ajassa

Suorita PowerShell-komentosarja

Suorittaa mukautetun PowerShell-komentosarjan ja hakee tuloksen muuttujaan.

Voit käyttää tätä toimintoa lisätäksesi omaa mukautettua PowerShell-koodiasi työpöytätyönkulkuun ja käyttääksesi siinä samalla muuttujia, jotta voit luoda dynaamista PowerShell-sisältöä tarvittaessa.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
PowerShell code to run	Kyllä	Tekstin arvo		Suoritettava PowerShell-komentosarjan koodi. Muuttujat voidaan sisällyttää komentosarjaan, koska ne arvioidaan ennen PowerShell-koodin suorittamista
Merkitse epäonnistuneeksi aikakatkaisun jälkeen	Kyllä	Totuusarvo		Määritä, suoritetaanko PowerShell-komentosarja pysyvästi vai epäonnistuuko se tietyn ajan kuluttua
Timeout	Ei	Numeerinen arvo	10	Enimmäismäärä sekunteja, joiden kuluttua komentosarja valmistuu (-1 jatkuu loputtomasti)

Tuotetut muuttujat

Argumentti	Type	Description
PowershellOutput	Tekstiarvo	Komentosarjan tulos
ScriptError	Tekstin arvo	PowerShell-koodin suorittamisen aikaiset mahdolliset virheet

Poikkeukset

Poikkeus	Kuvaus
PowerShell-komentosarjan suorittaminen epäonnistui	Osoittaa, että annetun PowerShell-komentosarjan suorittamisessa on ongelma
Komentosarjan suorittaminen määritetyssä ajassa epäonnistui	Ilmaisee ongelman suoritettaessa annettua komentosarjaa määritetyssä ajassa

Suorita Python-komentosarja

Suorittaa Python-komentosarjan koodin ja noutaa sen tulosteen.

Syöteparametrit

Argumentti	Valinnainen	Hyväksyy	Oletusarvo	Description
Python script to run	No	Tekstiarvo		Suoritettava Python-komentosarjan koodi
Python-versio	No	Python 2.7, Python 3.4	Python 2.7	Määritä, mitä Python-versiota käytetään komentosarjaa suoritettaessa
Module folder paths	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-komentosarjan koodin suorittamisen aikaiset mahdolliset virheet

Poikkeukset

Poikkeus	Kuvaus
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		.NET-komentosarjan tuonnit, jotka otetaan mukaan komentosarjaan
Ladattavat viittaukset	Kyllä	Kansio		Pääpolku, johon .NET dynaamisten linkkikirjastojen (.dll-tiedostot) viittaukset ovat
Komentosarjan parametrit	Kyllä	Käyttäjän määrittämät komentosarjan parametrit		Komentosarjassa määritettyjen parametrien arvojen määrittäminen
Suoritettava .NET-koodi	Ei	Tekstiarvo		Suoritettava .NET-koodi

Tuotetut muuttujat

Tämä toiminto voi tuottaa muuttujia käyttäjän Komentosarjan parametrit -ikkunassa tekemien määritysten mukaan.

Muistiinpano

Jos toiminto on määritetty tuottamaan tulosparametreja (Ulos-suunnan käyttäminen niiden määrittämisessä), sinun olisi aina varmistettava, että komentosarjassa olevan parametrin arvo on muu kuin tyhjä. Muussa tapauksessa komentosarjan suorituksen tuloksena on virhe, koska tulosparametria ei ole määritetty.

Poikkeukset

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