Betik eylemleri

Önemli

Yetkisiz erişimi önlemek için, Windows korumalı kaynaklara erişmek için Yönetici hakları gerektirir. Komut dosyası eylemlerini kullanarak korumalı kaynaklara (dosyalar gibi) erişmek için Power Automate'i yönetici haklarıyla çalıştırın. Power Automate'i yönetici olarak çalıştırma hakkında daha fazla bilgi için Power Automate'i yükseltilmiş haklarla çalıştırma bölümüne gidin.

Betik eylemleri, kod bloklarını çalıştırmanızı ve masaüstü akışlarınıza özel davranışlar uygulamanızı sağlar.

Önemli

Ekim 2023'te duyurulduğu üzere VBScript, Windows kullanım dışıdır. Windows'un gelecek sürümlerinde, VBScript işletim sisteminden kaldırmadan önce isteğe bağlı bir özellik olarak kullanılabilir olacaktır. Daha fazla bilgi için bkz. Kullanımdan kaldırılan özellikler için kaynaklar.

Tüm betik eylemleri, ilgili programlama veya betik dilinin temel yapısını izler: PowerShell, Python, VBScript, JavaScript ve C#/VB.NET.

Not

C# için desteklenen sürüm: v 5.0. VB.NET için: v 11.0

Yardımcı pilot ile desteklenen betik için doğal dil (önizleme)

[Bu konu yayın öncesi belgesine dahildir ve değiştirilebilir.]

Doğal kodlama dili masaüstü için Power Automate uygulamasına yeni eklenen bir yardımcı pilot özelliğidir. Betik oluşturma eylemlerinde kullanılan kodu açıklayarak hızlı bir şekilde oluşturmanıza olanak tanır. Bu özellik aşağıdaki betik oluşturma eylemlerinde kullanılabilir:

• PowerShell'i çalıştırma
• VBScript çalıştır
• DOS komutu çalıştır
• Python'ı çalıştırma
• JavaScript'i çalıştır

Önemli

• Bu, bir önizleme özelliğidir.
• Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.

Bölgeye göre kullanılabilirlik

Şu anda, masaüstü için Power Automate uygulamasında yardımcı pilot yalnızca Amerika Birleşik Devletleri'nde bulunan ortamlarda kullanılabilir.

Firma türüne göre kullanılabilirlik

Şu anda, masaüstü için Power Automate uygulamasında yardımcı pilot yalnızca bir iş veya okul hesabı olan kullanıcılar tarafından kullanılabilir.

Not

Ortamınız daha önce listelenen bölgelerden birindeyse ve masaüstü için Power Automate deneyiminde yardımcı pilotu görmeye devam etmeniz gerekiyorsa kiracı yöneticinize başvurun. Yönetici yardımcı işlevselliğini kapatmış olabilir.

Yardımcı pilot ve doğal dil kullanarak betik oluşturma

Desteklenen betik oluşturma eylemlerinden birinde betik oluşturmak için eylemi sürükleyip tasarımcıya bırakın ve Copilot ile betik oluşturma seçeneğini belirleyin.

Doğal dil isteminizi yazabileceğiniz, oluşturma istem ekranı açılır.

Betik oluşturmak için isteminizi yazın ve Oluştur'u seçin. Betiği yeniden oluşturmanız gerekirse, istemi değiştirebilir ve Yeniden Oluştur'u seçebilirsiniz. Yeniden oluşturmanız gerekmiyorsa, betiği değiştirip gerekli değişkenleri ekleyebileceğiniz ana eylem penceresine geri dönmek için Bu betiği kullan seçeneğini belirleyin.

Önemli

Yapay zeka modeli tarafından oluşturulan içeriği mutlaka gözden geçirin.

Bu özelliği geliştirme konusunda bize yardımcı olun

Yapay zeka tarafından oluşturulan içeriğin altındaki olumlu veya olumsuz görüş simgesini seçerek geri bildirim gönderin. Bunu yaptığınızda, Microsoft'a geri bildirim göndermek için kullanabileceğiniz bir geri bildirim iletişim kutusu görüntülenir.

Not

Bu iletişim kutusunu göremiyorsanız, kiracı yöneticiniz iletişim kutusunu kapatmış olabilir. Daha fazla bilgi: Kullanıcı geri bildirim işlevini devre dışı bırakma

Kullanıcı geri bildirim işlevini devre dışı bırakma

Power Platform yöneticisi olarak “Copilot geri bildirimi” kullanarak kullanıcıların Microsoft'a Copilot geri bildirimi göndermesini engelleme kiracı ayarı.

Kullanıcı geri bildirimlerine ilişkin veri sahibi hak talepleri

Kiracı yöneticileri, Microsoft 365 yönetim merkezinde oturum açıp Durum>Ürün geri bildirimi bölümüne giderek kullanıcılarından gelen geri bildirimleri görüntüleyebilir, dışarı aktarabilir ve silebilir.

Power Automate kaynaklarına sahip yapay zeka

• Doğal dille betik oluşturma ile ilgili SSS
• Power Automate için sorumlu AI ile ilgili SSS
• Microsoft Power Platform'da Copilot veri güvenliği ve gizliliği ile ilgili SSS

Betik oluşturma eylemlerinde değişkenlerle çalışma

Power Automate'te komut dosyası eylemlerinde değişkenleri bildirmek ve sonuçları döndürmek için aşağıdaki komutları kullanın:

• PowerShell komut dosyalarında yeni değişkenler bildirmek için $ gösterimini kullanın. Değerleri PowerShell betiğini çalıştır eylemlerinden Power Automate'e döndürmek için Write-Output komutunu kullanın.

  $variableName = "variableValue"
  Write-Output $variableName
  

• Python komut dosyaları, yeni değişkenleri bildirmek için herhangi bir özel bildirim gerektirmez. Python komut dosyası çalıştır eylemlerinden değerleri döndürmek için print işlevini kullanın.

  variableName = "variableValue"
  print variableName
  

• VBScript, yeni değişkenleri bildirmek için herhangi bir özel bildirim gerektirmez. Değerleri VBScript çalıştır eylemlerinden Power Automate'e döndürmek için WScript.Echo işlevini kullanın.

  variableName = "variableValue"
  WScript.Echo variableName
  

• JavaScript komut dosyalarında, yeni değişkenler bildirmek için var gösterimini ve JavaScript Çalıştır eylemlerinden değer döndürmek için WScript.Echo işlevini kullanın.

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

• .NET betikleri için .NET betiği çalıştır eyleminin yapılandırma kartı üzerinden erişilen Betik Parametreleri penceresini kullanın. İlgili değişkenin türünü ayarlayabilirsiniz:

Ayrıca bunu .NET betiği için bir giriş (Doğrudan açılan listede Giriş seçeneği), betiğin çıkışı (Doğrudan açılan listede Çıkış seçeneği) veya ikisi birden (Doğrudan açılan listede Giriş-Çıkış seçeneği) olarak ayarlayabilirsiniz.

Komut dosyası eylemlerinde Power Automate değişkenlerini kullanmak için yüzde gösterimini (%) kullanın ve değişkenleri sabit kodlanmış değerlerle aynı şekilde işleyin.

DOS komutu çalıştır

DOS komutu veya konsol uygulamasını görünmez modda yürütür ve işlem tamamlandıktan sonra çıktısını alır.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Tanım
DOS command or application	Hayır	Dosya		Varsa bağımsız değişkenlerle birlikte DOS komutu veya konsol uygulaması adı
Working folder	Evet	Klasör		Varsa çalışılacak klasörün tam yolu
Zaman aşımı sonrası başarısız olma	Evet	Boole değeri		DOS komutu veya uygulamasının süresiz olarak mı çalışacağını yoksa belirli bir süre sonra başarısız mı olacağını belirtin
Timeout	Hayır	Sayısal değer	10	Betiğin tamamlanması için beklenecek maksimum saniye sayısı (süresiz için -1)
Change code page	Geçersiz	Boole değeri	False	Oturumun geçerli kod sayfasının değiştirilip değiştirilmeyeceğini belirtir
Encoding	Hayır	ASMO-708: Arapça (ASMO 708), big5: Çince (Geleneksel) (Big5), cp1025: IBM EBCDIC (Kiril Sırpça-Bulgarca), cp866: Kiril (DOS), cp875: IBM EBCDIC (Modern Yunanca), csISO2022JP: Japonca (JIS-1 bayt Kana'ya izin verir), DOS-720: Arapça (DOS), DOS-862: İbranice (DOS), EUC-CN: Çince (Basitleştirilmiş) (EUC), EUC-JP: Japonca (JIS 0208-1990 ve 0212-1990), euc-jp: Japonca (EUC), euc-kr: Korece (EUC), GB18030: Çince (Basitleştirilmiş) (GB18030), gb2312: Çince (Basitleştirilmiş) (GB2312), hz-gb-2312: Çince (Basitleştirilmiş) (HZ), IBM-Tay dili: IBM EBCDIC (Tay dili), IBM00858: OEM Çok Dilli Latin I, IBM00924: IBM Latin-1, IBM01047: IBM Latin-1, IBM01140: IBM EBCDIC (ABD-Kanada-Avrupa), IBM01141: IBM EBCDIC (Almanya-Avrupa), IBM01142: IBM EBCDIC (Danimarka-Norveç-Avrupa), IBM01143: IBM EBCDIC (Finlandiya-İsveç-Avrupa), IBM01144: IBM EBCDIC (İtalya-Avrupa), IBM01145: IBM EBCDIC (İspanyolca-Avrupa), IBM01146: IBM EBCDIC (Birleşik Krallık-Avrupa), IBM01147: IBM EBCDIC (Fransa-Avrupa), IBM01148: IBM EBCDIC (Uluslararası-Avrupa), IBM01149: IBM EBCDIC (İzlandaca-Avrupa), IBM037: IBM EBCDIC (ABD-Kanada), IBM1026: IBM EBCDIC (Türkçe Latin-5), IBM273: IBM EBCDIC (Almanya), IBM277: IBM EBCDIC (Danimarka-Norveç), IBM278: IBM EBCDIC (Finlandiya-İsveç), IBM280: IBM EBCDIC (İtalya), IBM284: IBM EBCDIC (İspanya), IBM285: IBM EBCDIC (Birleşik Krallık), IBM290: IBM EBCDIC (Japonca Katakana), IBM297: IBM EBCDIC (Fransa), IBM420: IBM EBCDIC (Arapça), IBM423: IBM EBCDIC (Yunanca), IBM424: IBM EBCDIC (İbranice), IBM437: OEM ABD, IBM500: IBM EBCDIC (Uluslararası), ibm737: Yunanca (DOS), ibm775: Baltık (DOS), ibm850: Batı Avrupa (DOS), ibm852: Orta Avrupa (DOS), IBM855: OEM Kiril, ibm857: Türkçe (DOS), IBM860: Portekizce (DOS), ibm861: İzlandaca (DOS), IBM863: Kanada Fransızcası (DOS), IBM864: Arapça (864), IBM865: İskandinav (DOS), ibm869: Yunanca, Modern (DOS), IBM870: IBM EBCDIC (Çok Dilli Latin-2), IBM871: IBM EBCDIC (İzlandaca), IBM880: IBM EBCDIC (Kiril Rusça), IBM905: IBM EBCDIC (Türkçe), iso-2022-jp: Japonca (JIS), iso-2022-jp: Japonca (JIS-1 bayt Kana'ya izin verir - SO/SI), iso-2022-kr: Korece (ISO), iso-8859-1: Batı Avrupa (ISO), iso-8859-13: Estonca (ISO), iso-8859-15: Latin 9 (ISO), iso-8859-2: Orta Avrupa (ISO), iso-8859-3: Latin 3 (ISO), iso-8859-4: Baltık (ISO), iso-8859-5: Kiril (ISO), iso-8859-6: Arapça (ISO), iso-8859-7: Yunanca (ISO), iso-8859-8: İbranice (ISO-Görsel), iso-8859-8-i: İbranice (ISO-Mantıksal), iso-8859-9: Türkçe (ISO), Johab: Korece (Johab), koi8-r: Kiril (KOI8-R), koi8-u: Kiril (KOI8-U), ks_c_5601-1987: Korece, macintosh: Batı Avrupa (Mac), shift_jis: Japonca (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: Orta Avrupa (Windows), windows-1251: Kiril (Windows), Windows-1252: Batı Avrupa (Windows), windows-1253: Yunanca (Windows), windows-1254: Türkçe (Windows), windows-1255: İbranice (Windows), windows-1256: Arapça (Windows), windows-1257: Baltık (Windows), windows-1258: Vietnamca (Windows), windows-874: Tayca (Windows), x-Chinese-CNS: Çince (Geleneksel) (CNS), x-Chinese-Eten: Çince (Geleneksel) (Eten), x-cp20001: TCA Tayvan, x-cp20003: IBM5550 Tayvan, x-cp20004: TeleText Tayvan, x-cp20005: Wang Tayvan, x-cp20261: T.61, x-cp20269: ISO-6937, x-cp20936: Çince (Basitleştirilmiş) (GB2312-80), x-cp20949: Korece Wansung, x-cp50227: Çince (Basitleştirilmiş) (ISO-2022), x-EBCDIC-KoreanExtended: IBM EBCDIC (Korece Genişletilmiş), x-Europa: Avrupa, x-IA5: Batı Avrupa (IA5), x-IA5-German: Almanca (IA5), x-IA5-Norwegian: Norveççe (IA5), x-IA5-Swedish: İsveççe (IA5), x-iscii-as: ISCII Assamca, x-iscii-be: ISCII Bengalce, x-iscii-de: ISCII Devanagari, x-iscii-gu: ISCII Güceratça, x-iscii-ka: ISCII Kannada dili, x-iscii-ma: ISCII Malayalam dili, x-iscii-or: ISCII Oriya dili, x-iscii-pa: ISCII Pencapça, x-iscii-ta: ISCII Tamilce, x-iscii-te: ISCII Telugu dili, x-mac-arabic: Arapça (Mac), x-mac-ce: Orta Avrupa (Mac), x-mac-chinesesimp: Çince (Basitleştirilmiş) (Mac), x-mac-chinesetrad: Çince (Geleneksel) (Mac), x-mac-croatian: Hırvatça (Mac), x-mac-cyrillic: Kiril (Mac), x-mac-greek: Yunanca (Mac), x-mac-hebrew: İbranice (Mac), x-mac-icelandic: İzlandaca (Mac), x-mac-japanese: Japonca (Mac), x-mac-korean: Korece (Mac), x-mac-romanian: Rumence (Mac), x-mac-thai: Tayca (Mac), x-mac-turkish: Türkçe (Mac), x-mac-ukrainian: Ukraynaca (Mac)`	utf-8 : Unicode (UTF-8)	Çıkış okunurken kullanılacak kodlama

Değişkenler üretildi

Bağımsız değişken	Türü	Tanım
CommandOutput	Metin değeri	DOS komutu veya uygulamanın metin çıktısı
CommandErrorOutput	Metin değeri	DOS komutu veya uygulamanın yürütülmesi sırasında oluşan hataları (varsa) açıklayan metin
CommandExitCode	Sayısal değer	Komut veya uygulama çıkış kodu. Bu değer sayısaldır

Özel durumlar

Özel durum	Veri Akışı Açıklaması
Komut veya konsol uygulaması yürütülemiyor	Belirtilen komutu veya konsol uygulamasını yürütmeyle ilgili bir sorun olduğunu belirtir
Betik, ayrılan süre içinde çalıştırılamadı	Belirtilen betiğin belirtilen süre içinde çalıştırılmasıyla ilgili bir sorun olduğunu gösterir

VBScript çalıştır

Bazı özel VBScript kodlarını yürütür ve çıktısını bir değişkene alır.

Aynı zamanda burada değişkenleri kullanma yeteneğine sahip olurken, gerektiğinde dinamik VBScript içeriği oluşturmak için kendi özel VBScript kodunuzu masaüstü akışına eklemek için bu eylemi kullanabilirsiniz.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Tanım
VBScript to run	Evet	Metin değeri		Yürütülecek VBScript kodu. VBScript yürütülmeden önce değerlendirildikleri için değişkenler betiğe dahil edilebilir
Zaman aşımı sonrası başarısız olma	Evet	Boole değeri	Geçersiz	VBScript betiğinin süresiz olarak mı çalışacağını yoksa belirli bir süre sonra başarısız mı olacağını belirtin
Timeout	Hayır	Sayısal değer	10	Betiğin tamamlanması için beklenecek maksimum saniye sayısı (süresiz için -1)

Değişkenler üretildi

Bağımsız değişken	Türü	Description
VBScriptOutput	Metin değeri	Betiğin çıktısı
ScriptError	Metin değeri	VBScript kodu yürütülürken ortaya çıkabilecek hatalar

Özel durumlar

Özel durum	Description
Betik, ayrılan süre içinde çalıştırılamadı	Belirtilen betiğin belirtilen süre içinde çalıştırılmasıyla ilgili bir sorun olduğunu gösterir

JavaScript'i çalıştır

Bazı özel JavaScript kodlarını yürütür ve çıktısını bir değişkene alır.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Tanım
JavaScript to run	Evet	Metin değeri		Yürütülecek JavaScript kodu. JavaScript kodu yürütülmeden önce değerlendirildikleri için değişkenler betiğe dahil edilebilir
Zaman aşımı sonrası başarısız olma	Evet	Boole değeri		JavaScript betiğinin süresiz olarak mı çalışacağını yoksa belirli bir süre sonra başarısız mı olacağını belirtin
Timeout	Hayır	Sayısal değer	10	Betiğin tamamlanması için beklenecek maksimum saniye sayısı (süresiz için -1)

Değişkenler üretildi

Bağımsız değişken	Türü	Description
JavascriptOutput	Metin değeri	Betiğin çıktısı
ScriptError	Metin değeri	JavaScript kodu yürütülürken ortaya çıkabilecek hatalar

Özel durumlar

Özel durum	Description
Betik, ayrılan süre içinde çalıştırılamadı	Belirtilen betiğin belirtilen süre içinde çalıştırılmasıyla ilgili bir sorun olduğunu gösterir

PowerShell betiğini çalıştır

Bazı özel PowerShell betiklerini yürütür ve çıktısını bir değişkene alır.

Aynı zamanda burada değişkenleri kullanma yeteneğine sahip olurken, gerektiğinde dinamik PowerShell içeriği oluşturmak için kendi özel PowerShell kodunuzu masaüstü akışına eklemek için bu eylemi kullanabilirsiniz.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Tanım
PowerShell code to run	Evet	Metin değeri		Yürütülecek PowerShell kodu. PowerShell kodu yürütülmeden önce değerlendirildikleri için değişkenler betiğe dahil edilebilir
Zaman aşımı sonrası başarısız olma	Evet	Boole değeri		PowerShell betiğinin süresiz olarak mı çalışacağını yoksa belirli bir süre sonra başarısız mı olacağını belirtin
Timeout	Hayır	Sayısal değer	10	Betiğin tamamlanması için beklenecek maksimum saniye sayısı (süresiz için -1)

Değişkenler üretildi

Bağımsız değişken	Türü	Description
PowershellOutput	Metin değeri	Betiğin çıktısı
ScriptError	Metin değeri	PowerShell kodu yürütülürken ortaya çıkabilecek hatalar

Özel durumlar

Özel durum	Açıklama
PowerShell betiği çalıştırılamadı	Sağlanan PowerShell betiğini çalıştırırken bir sorun olduğunu gösterir
Betik, ayrılan süre içinde çalıştırılamadı	Belirtilen betiğin belirtilen süre içinde çalıştırılmasıyla ilgili bir sorun olduğunu gösterir

Python betiğini çalıştır

Python betik kodunu yürütür ve çıktısını alır.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Veri Akışı Açıklaması
Python script to run	No	Metin değeri		Yürütülecek Python betiği kodu
Python sürümü	No	Python 2.7, Python 3.4	Python 2.7	Betik yürütülürken hangi Python sürümünün kullanılacağını belirtin
Module folder paths	Evet	Klasörlerlistesi		Harici Python modüllerinin bulunduğu klasörlerin yolları

Değişkenler üretildi

Bağımsız değişken	Türü	Veri Akışı Açıklaması
PythonScriptOutput	Metin değeri	Betiğin çıktısı
ScriptError	Metin değeri	Python betik kodu yürütülürken ortaya çıkabilecek hatalar

Özel durumlar

Özel durum	Açıklama
Python betiği çalıştırılamadı	Sağlanan Python betiğini çalıştırırken bir sorun olduğunu gösterir
Dizin bulunamadı	Dizinin bulunamadığını gösterir

.NET betiği çalıştır

.NET (C#/VB.NET) betik kodunu yürütür ve çıktısını alır.

Giriş parametreleri

Bağımsız değişken	İsteğe bağlı	Kabul eder	Varsayılan Değer	Veri Akışı Açıklaması
Dil	Geçersiz	C#/ VB.NET	C#	Komut dosyasının dili
.NET betik içeri aktarmaları	Evet	Metin değeri		Komut dosyasına dahil edilecek .NET komut dosyası içeri aktarma işlemleri
Yüklenecek başvurular	Evet	Klasör		.NET dinamik bağlantı kitaplıkları (.dll dosyaları) başvurularının bulunduğu kök yol
Betik parametreleri	Evet	Kullanıcı tarafından tanımlanan Betik Parametreleri		Betikte tanımlanan parametrelerin değerlerini ayarlama
Çalıştırılacak .NET kodu	Hayır	Metin değeri		Çalıştırılacak .NET kodu

Değişkenler üretildi

Bu eylem, Betik Parametreleri penceresini kullanırken kullanıcı tarafından yapılan yapılandırmaya bağlı olarak değişken üretebilir.

Not

Eylemin çıkış parametreleri üretmek için (yapılandırırken Çıkış yönünü kullanarak) yapılandırılması durumunda betiğin içindeki parametrenin null dışında bir değere ayarlandığından her zaman emin olmanız gerekir. Aksi takdirde, çıkış parametresi ayarlanmadığından betik yürütme bir hataya neden olur.

Özel durumlar

Özel durum	Description
.NET betiği çalıştırılamadı	Sağlanan .NET betiğini çalıştırırken bir sorun olduğunu gösterir