Eylem Komut Çalıştırmalarını kullanarak Windows sanal makinenizde betikleri çalıştırma

Komut Çalıştır özelliği, Azure Windows VM'sinde PowerShell betiklerini çalıştırmak için sanal makine (VM) aracısını kullanır. Genel makine veya uygulama yönetimi için bu betikleri kullanabilirsiniz. Vm erişimi ve ağ sorunlarını hızla tanılamanıza ve düzeltmenize ve VM'yi yeniden iyi bir duruma döndürmenize yardımcı olabilir.

Sosyal haklar

Sanal makinelerinize birden çok yolla erişebilirsiniz. Komutunu Çalıştır, SANAL makine aracısını kullanarak sanal makinelerinizde betikleri uzaktan çalıştırabilir. Komutunu Azure portalı, REST API veya Windows VM'leri için PowerShell aracılığıyla kullanırsınız.

Bu özellik, bir sanal makine içinde betik çalıştırmak istediğiniz tüm senaryolarda kullanışlıdır. Hatalı ağ veya yönetici kullanıcı yapılandırması nedeniyle RDP veya SSH bağlantı noktası açık olmayan bir sanal makinede sorun gidermenin ve düzeltmenin tek yollarından biridir.

Önkoşullar

Windows İşletim Sistemi Desteği

Windows İşletim Sistemi	x64
Windows 10	Desteklenir
Windows 11	Desteklenir
Windows Server 2008 SP2	Desteklenir
Windows Server 2008 R2	Desteklenir
Windows Server 2012	Desteklenir
Windows Server 2012 R2	Desteklenir
Windows Server 2016	Desteklenir
Windows Server 2016 Core	Desteklenir
Windows Server 2019	Desteklenir
Windows Server 2019 Core	Desteklenir
Windows Server 2022	Desteklenir
Windows Server 2022 Core	Desteklenir

Kısıtlamalar

Run Komutunu kullanırken aşağıdaki kısıtlamalar geçerlidir:

• Çıkış son 4.096 baytla sınırlıdır.
• Bu betiği çalıştırmak için minimum süre 20 saniye kadardır.
• Betikler Windows'da Sistem olarak çalıştırılır.
• Bir kerede tek bir betik çalıştırılabilir.
• Bilgi isteyen betikler (etkileşimli mod) desteklenmez.
• Çalışan bir betiği iptal edemezsiniz.
• Betiğin çalıştırılabileceği maksimum süre 90 dakikadır. Bu süreden sonra zaman aşımına uğrar.
• Betiğin sonuçlarını döndürmek için sanal makineden giden bağlantı gerekir.
• VM Aracısı'nın durdurulmasına veya güncelleştirilmasına neden olacak bir betiğin çalıştırılması önerilmez. Bu uzantıyı Geçiş durumuna geçirebilir ve zaman aşımına yol açar.

Not

Düzgün çalışmak için Çalıştır Komutu, Azure genel IP adreslerine bağlantı (bağlantı noktası 443) gerektirir. Uzantının bu uç noktalara erişimi yoksa betikler başarıyla çalıştırılabilir ancak sonuçları döndürmez. Sanal makinedeki trafiği engelliyorsanız, etiketini kullanarak AzureCloud Azure genel IP adreslerine giden trafiğe izin vermek için hizmet etiketlerini kullanabilirsiniz.

VM aracısı durumu HAZIR DEĞİlse Komut Çalıştır özelliği çalışmaz. Azure portalında VM'nin özelliklerinde aracı durumunu denetleyin.

Kullanılabilir komutlar

Bu tabloda, Windows VM'leri için kullanılabilen komutların listesi gösterilir. İstediğiniz özel betiği çalıştırmak için RunPowerShellScript komutunu kullanabilirsiniz. Bir komutu çalıştırmak için Azure CLI veya PowerShell kullanırken, veya -CommandId parametresi için --command-id sağladığınız değer aşağıdaki listelenen değerlerden biri olmalıdır. Kullanılabilir bir komut olmayan bir değer belirttiğinizde şu hatayı alırsınız:

The entity was not found in this Azure location

Ad	Açıklama
RunPowerShellScript	PowerShell betiği çalıştırır
NLA'yi Devre Dışı Bırak	Ağ Düzeyinde Kimlik Doğrulamayı Devre Dışı Bırak
DisableWindowsUpdate	Windows Update Otomatik Güncelleştirmelerini devre dışı bırakma
EnableAdminAccount	Yerel yönetici hesabının devre dışı bırakılıp bırakılmadiğini ve etkinleştirilip etkinleştirmediğini denetler.
ENABLEEMS	EMS'yi etkinleştirir
EnableRemotePS	Makineyi uzak PowerShell'i etkinleştirecek şekilde yapılandırıyor.
EnableWindowsUpdate	Windows Update Otomatik Güncelleştirmelerini Etkinleştirme
IPConfig	TCP/IP'ye bağlı her bağdaştırıcı için IP adresi, alt ağ maskesi ve varsayılan ağ geçidi için ayrıntılı bilgileri gösterir.
RDPSettings	Kayıt defteri ayarlarını ve etki alanı ilkesi ayarlarını denetler. Makine bir etki alanının parçasıysa veya ayarları varsayılan değerlerle değiştirirse ilke eylemleri önerir.
ResetRDPCert	RDP dinleyicisine bağlı TLS/SSL sertifikasını kaldırır ve RDP dinleyicisi güvenliğini varsayılan olarak geri yükler. Sertifikayla ilgili herhangi bir sorun görürseniz bu betiği kullanın.
SetRDPPort	Uzak Masaüstü bağlantıları için varsayılan veya kullanıcı tarafından belirtilen bağlantı noktası numarasını ayarlar. Bağlantı noktasına gelen erişim için güvenlik duvarı kurallarını etkinleştirir.

Azure CLI

Aşağıdaki örnekte az vm run-command komutu kullanılarak Azure Windows VM'sinde kabuk betiği çalıştırılır.

# script.ps1
#   param(
#       [string]$arg1,
#       [string]$arg2
#   )
#   Write-Host This is a sample script with parameters $arg1 and $arg2

az vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar"

Azure portal

Azure portalında bir VM'ye gidin ve soldaki menüden İşlemler'in altında Çalıştır komutunu seçin. VM'de çalıştırılacak kullanılabilir komutların listesini görürsünüz.

Çalıştırılacak komutu seçin. Bazı komutların isteğe bağlı veya gerekli giriş parametreleri olabilir. Bu komutlar için parametreler, giriş değerlerini sağlamanız için metin alanları olarak sunulur. Her komut için Betiği görüntüle'yi genişleterek çalıştırılan betiği görüntüleyebilirsiniz. RunPowerShellScript , kendi özel betiğinizi sağlamanıza olanak sağladığından diğer komutlardan farklıdır.

Not

Yerleşik komutlar düzenlenemez.

Komutu seçtikten sonra çalıştır'ı seçerek betiği çalıştırın. Betik tamamlandıktan sonra çıktıyı ve çıkış penceresindeki hataları döndürür. Aşağıdaki ekran görüntüsünde RDPSettings komutunu çalıştırmaya yönelik örnek bir çıkış gösterilmektedir .

PowerShell

Aşağıdaki örnek, Azure VM'de PowerShell betiği çalıştırmak için Invoke-AzVMRunCommand cmdlet'ini kullanır. cmdlet'i, parametresinde başvuruda bulunulduğu betiğin -ScriptPath cmdlet'in çalıştırıldığı yere yerel olmasını bekler.

Invoke-AzVMRunCommand -ResourceGroupName '<myResourceGroup>' -Name '<myVMName>' -CommandId 'RunPowerShellScript' -ScriptPath '<pathToScript>' -Parameter @{"arg1" = "var1";"arg2" = "var2"}

Not

Parametre değerleri yalnızca dize türü olabilir ve betik gerekirse bunları diğer türlere dönüştürmekle sorumludur.

Komut Çalıştırma'ya erişimi sınırlama

Çalıştırma komutlarının listelenmesi veya bir komutun ayrıntılarının gösterilmesi için Abonelik Düzeyinde izin gerekir Microsoft.Compute/locations/runCommands/read . Yerleşik Okuyucu rolü ve üst düzeyler bu izne sahiptir.

Komut çalıştırmak için izin gerekir Microsoft.Compute/virtualMachines/runCommands/action . Sanal Makine Katılımcısı rolü ve üst düzeyler bu izne sahiptir.

Komut Çalıştır'ı kullanmak için yerleşik rollerden birini kullanabilir veya özel bir rol oluşturabilirsiniz.

Eylem Çalıştırma Komutu Windows sorunlarını giderme

Windows ortamları için eylem çalıştırma komutunun sorunlarını giderirken, diğer ayrıntılar için genellikle aşağıdaki dizinde bulunan RunCommandExtension günlük dosyasına bakın: C:\WindowsAzure\Logs\Plugins\Microsoft.CPlat.Core.RunCommandWindows\<version>\RunCommandExtension.log

Bilinen sorunlar

Komut ayrılmış karakterler içeriyorsa Eylem Çalıştırma Komut Uzantınız Windows ortamınızda yürütülemeyebilir. Örneğin:

& Simge aşağıdaki PowerShell betiği gibi komutunuzun parametresinde geçirilirse başarısız olabilir.

$paramm='abc&jj'
Invoke-AzVMRunCommand -ResourceGroupName AzureCloudService1 -Name test -CommandId 'RunPowerShellScript' -ScriptPath C:\data\228332902\PostAppConfig.ps1 -Parameter @{"Prefix" = $paramm}

^ bağımsız değişkeninde kaçış & karakteri kullanın, örneğin$paramm='abc^&jj'

Çalıştır Komutu uzantısı, yürütülecek komut yolda "\n" içeriyorsa, yeni bir satır olarak ele alınacağı için yürütülemeyebilir. Örneğin, C:\Windows\notepad.exe dosya yolunda öğesini içerir \n . yolunuz içinde ile \N öğesini değiştirmeyi \n göz önünde bulundurun.

Eylem Çalıştırma Komutunu Kaldırma

Eylem çalıştırma komutu Windows uzantısını kaldırmanız gerekiyorsa Azure PowerShell ve CLI için aşağıdaki adımlara bakın:

Aşağıdaki kaldırma örneklerinde rgname ve vmname değerini ilgili kaynak grubu adınız ve sanal makine adınızla değiştirin.

 Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -VMName 'vmname' -CommandId 'RemoveRunCommandWindowsExtension'

az vm run-command invoke  --command-id RemoveRunCommandWindowsExtension --name vmname -g rgname

Not

Çalıştırma Komutunu yeniden uyguladığınızda uzantı otomatik olarak yüklenir. Uzantıyla ilgili sorunları gidermek için uzantı kaldırma komutunu kullanabilirsiniz.

Sonraki adımlar

Sanal makinenizde betikleri ve komutları uzaktan çalıştırmanın diğer yolları hakkında bilgi edinmek için bkz . Windows VM'nizde betikleri çalıştırma.