Windows üzerinde Linux için IoT Edge'e yönelik PowerShell işlevleri

Şunlar için geçerlidir: IoT Edge 1.4

Windows üzerinde Linux için IoT Edge (EFLOW) sanal makinenizi dağıtan, sağlayan ve durumunu alan PowerShell işlevlerini anlayın.

Önkoşullar

Bu makalede açıklanan komutlar dosyasından AzureEFLOW.psm1 alınıyor. Bu komutlar, dizininizdeki dizininizde WindowsPowerShell altında C:\Program Files\WindowsPowerShell\Modules\AzureEFLOWbulunabilir.

PowerShell dizininizde AzureEflow klasörünüz yoksa, Windows'da Linux için Azure IoT Edge'i indirmek ve yüklemek için aşağıdaki adımları kullanın:

1. Yükseltilmiş bir PowerShell oturumunda, Windows'da Linux için IoT Edge'i indirmek için aşağıdaki komutların her birini çalıştırın.

   • X64/AMD64

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_X64" -OutFile $msiPath
   

   • ARM64

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEFLOWMSI_1_4_LTS_ARM64" -OutFile $msiPath
   

2. Cihazınıza Windows üzerinde Linux için IoT Edge'i yükleyin.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Yükleme komutuna ve parametreleri ekleyerek INSTALLDIR="<FULLY_QUALIFIED_PATH>" özel yükleme ve VHDXDIR="<FULLY_QUALIFIED_PATH>" VHDX dizinleri belirtebilirsiniz.

3. Hedef cihazdaki yürütme ilkesini en az AllSignedolarak ayarlayın.

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Add-EflowNetwork

Add-EflowNetwork komutu, EFLOW sanal makinesine yeni bir ağ ekler. Bu komutta iki parametre kullanılır.

Dört özellik içeren bir nesne döndürür:

• Veri Akışı Adı
• AllocationMethod
• Cidr
• Tür

Daha fazla bilgi edinmek için Get-Help Add-EflowNetwork -full komutunu kullanın.

Add-EflowVmEndpoint

Add-EflowVmEndpoint komutu, EFLOW sanal makinesine yeni bir ağ uç noktası ekler. Statik IP ayarlamak için isteğe bağlı parametreleri kullanın.

Dört özellik içeren bir nesne döndürür:

• Veri Akışı Adı
• MacAddress
• HealthStatus
• IpConfiguration

Daha fazla bilgi edinmek için Get-Help Add-EflowVmEndpoint -full komutunu kullanın.

Add-EflowVmSharedFolder

Add-EflowVmSharedFolder komutu, EFLOW sanal makinesiyle bir veya daha fazla Windows ana bilgisayar işletim sistemi klasörünün paylaşılmasına olanak tanır.

JSON yapılandırma dosyası aşağıdaki yapıya sahip olmalıdır:

• sharedFOlderRoot : EFLOW sanal makinesiyle paylaşılacak tüm klasörleri içeren Windows kök klasörünün yolu.
• hostFolderPath: EFLOW VM ile paylaşılacak klasörün göreli yolu (üst kök klasörüne).
• readOnly: Paylaşılan klasörün EFLOW sanal makinesinden yazılabilir mi yoksa salt okunur mu olduğunu tanımlar - Değerler: false veya true.
• targetFolderOnGuest : Windows ana bilgisayar işletim sistemi klasörünün bağlandığı EFLOW sanal makinesinin içindeki klasör yolu.

[
   {
      "sharedFolderRoot": "<shared-folder-root-windows-path>",
      "sharedFolders": [ 
        { "hostFolderPath": "<path-shared-folder>", 
            "readOnly": "<read-only>", 
            "targetFolderOnGuest": "<linux-mounting-point>" 
        }
      ]
   }
]

Daha fazla bilgi edinmek için Get-Help Add-EflowVmSharedFolder -full komutunu kullanın.

Connect-EflowVm

Connect-EflowVm komutu SSH kullanarak sanal makineye bağlanır. Sanal makinede SSH'ye izin verilen tek hesap, bunu oluşturan kullanıcıdır.

Bu komut yalnızca konak cihazda çalışan bir PowerShell oturumunda çalışır. Windows Admin Center veya PowerShell ISE kullanılırken çalışmaz.

Daha fazla bilgi edinmek için Get-Help Connect-EflowVm -full komutunu kullanın.

Copy-EflowVmFile

Copy-EflowVmFile komutu, SCP kullanarak dosyayı sanal makineye veya sanal makineden kopyalar. Kaynak ve hedef dosya yollarını ve kopyanın yönünü belirtmek için isteğe bağlı parametreleri kullanın.

Kullanıcı iotedge-user , sanal makinedeki herhangi bir kaynak dizine okuma veya hedef dizinlere yazma iznine sahip olmalıdır.

Daha fazla bilgi edinmek için Get-Help Copy-EflowVMFile -full komutunu kullanın.

Eflow Dağıtma

Deploy-Eflow komutu ana dağıtım yöntemidir. Dağıtım komutu sanal makineyi oluşturur, dosyaları sağlar ve IoT Edge aracı modülünü dağıtır. Parametrelerin hiçbiri gerekli olmasa da, oluşturma sırasında sanal makinenin ayarlarını değiştirmek için kullanılabilir.

Daha fazla bilgi edinmek için Get-Help Deploy-Eflow -full komutunu kullanın.

Get-EflowHostConfiguration

Get-EflowHostConfiguration komutu konak yapılandırmasını döndürür. Bu komut parametre almaz. Dört özellik içeren bir nesne döndürür:

• FreePhysicalMemoryInMB
• NumberOfLogicalProcessors
• DiskInfo
• GpuInfo

Daha fazla bilgi edinmek için Get-Help Get-EflowHostConfiguration -full komutunu kullanın.

Get-EflowLogs

Get-EflowLogs komutu, Windows üzerinde Linux için IoT Edge dağıtım ve yüklemesinden günlükleri toplar ve paketler. Paketlenmiş günlüklerin çıkışını bir .zip klasör biçiminde oluşturur.

Daha fazla bilgi edinmek için Get-Help Get-EflowLogs -full komutunu kullanın.

Get-EflowNetwork

Get-EflowNetwork komutu, EFLOW sanal makinesine atanan ağların listesini döndürür. Belirli bir ağı almak için isteğe bağlı parametresini kullanın.

Dört özellik içeren nesnelerin listesini döndürür:

• Veri Akışı Adı
• AllocationMethod
• Cidr
• Tür

Daha fazla bilgi edinmek için Get-Help Get-EflowNetwork -full komutunu kullanın.

Get-EflowVm

Get-EflowVm komutu, sanal makinenin geçerli yapılandırmasını döndürür. Bu komut parametre almaz. Dört özellik içeren bir nesne döndürür:

• VmConfiguration
• VmPowerState
• EdgeRuntimeVersion
• EdgeRuntimeStatus
• SystemStatistics

Okunabilir bir listede belirli bir özelliği görüntülemek için komutunu özelliği genişletilmiş olarak çalıştırın Get-EflowVM . Örneğin:

Get-EflowVM | Select -ExpandProperty VmConfiguration | Format-List

Daha fazla bilgi edinmek için Get-Help Get-EflowVm -full komutunu kullanın.

Get-EflowVmAddr

Get-EflowVmAddr komutu, sanal makinenin geçerli IP ve MAC adresini sorgulamak için kullanılır. Bu komut, IP ve MAC adresinin zaman içinde değişebileceği gerçeğini hesaba eklemek için vardır.

Ek bilgi için komutunu Get-Help Get-EflowVmAddr -fullkullanın.

Get-EflowVmEndpoint

Get-EflowVmEndpoint komutu, EFLOW sanal makinesine atanan ağ uç noktalarının listesini döndürür. Belirli bir ağ uç noktasını almak için isteğe bağlı parametresini kullanın.

Dört özellik içeren nesnelerin listesini döndürür:

• Veri Akışı Adı
• MacAddress
• HealthStatus
• IpConfiguration

Daha fazla bilgi edinmek için Get-Help Get-EflowVmEndpoint -full komutunu kullanın.

Get-EflowVmFeature

Get-EflowVmFeature komutu, Windows özelliklerinde Linux için IoT Edge'in etkinleştirilme durumunu döndürür.

Daha fazla bilgi edinmek için Get-Help Get-EflowVmFeature -full komutunu kullanın.

Get-EflowVmName

Get-EflowVmName komutu, sanal makinenin geçerli ana bilgisayar adını döndürür. Bu komut, Windows ana bilgisayar adının zaman içinde değişebileceği gerçeğini hesaba eklemek için vardır.

Daha fazla bilgi edinmek için Get-Help Get-EflowVmName -full komutunu kullanın.

Get-EflowVmSharedFolder

Get-EflowVmSharedFolder komutu, EFLOW sanal makinesiyle paylaşılan bir veya daha fazla Windows ana bilgisayar işletim sistemi klasörü hakkındaki bilgileri döndürür.

Üç özellik içeren nesnelerin listesini döndürür:

• hostFolderPath: EFLOW VM ile paylaşılan klasörün göreli yolu (üst kök klasörüne).
• readOnly: Paylaşılan klasörün EFLOW sanal makinesinden yazılabilir mi yoksa salt okunur mu olduğunu tanımlar - Değerler: false veya true.
• targetFolderOnGuest: Windows klasörünün bağlandığı EFLOW sanal makinesinin içindeki klasör yolu.

Daha fazla bilgi edinmek için Get-Help Get-EflowVmSharedFolder -full komutunu kullanın.

Get-EflowVmTelemetryOption

Get-EflowVmTelemetryOption komutu, sanal makine içindeki telemetrinin durumunu (İsteğe bağlı veya Gerekli) görüntüler.

Daha fazla bilgi edinmek için Get-Help Get-EflowVmTelemetryOption -full komutunu kullanın.

Get-EflowVmTpmProvisioningInfo

Get-EflowVmTpmProvisioningInfo komutu TPM sağlama bilgilerini döndürür. Bu komut parametre almaz. İki özellik içeren bir nesne döndürür:

• Onay Anahtarı
• Kayıt Kimliği

Daha fazla bilgi edinmek için Get-Help Get-EflowVmTpmProvisioningInfo -full komutunu kullanın.

Invoke-EflowVmCommand

Invoke-EflowVMCommand komutu sanal makinenin içinde bir Linux komutu yürütür ve çıkışı döndürür. Bu komut yalnızca sonlu bir çıkış döndüren Linux komutları için çalışır. Kullanıcı etkileşimi gerektiren veya süresiz olarak çalışan Linux komutları için kullanılamaz.

Komutu önceden belirtmek için aşağıdaki isteğe bağlı parametreler kullanılabilir.

Daha fazla bilgi edinmek için Get-Help Invoke-EflowVmCommand -full komutunu kullanın.

Provision-EflowVm

Provision-EflowVm komutu, IoT Edge cihazınız için sağlama bilgilerini sanal makinenin IoT Edge config.yaml dosyasına ekler.

Daha fazla bilgi edinmek için Get-Help Provision-EflowVm -full komutunu kullanın.

Remove-EflowNetwork

Remove-EflowNetwork komutu, EFLOW sanal makinesine bağlı mevcut bir ağı kaldırır. Bu komut bir parametre alır.

Daha fazla bilgi edinmek için Get-Help Remove-EflowNetwork -full komutunu kullanın.

Remove-EflowVmEndpoint

Remove-EflowVmEndpoint komutu, EFLOW sanal makinesine bağlı mevcut bir ağ uç noktasını kaldırır. Bu komut bir parametre alır.

Daha fazla bilgi edinmek için Get-Help Remove-EflowVmEndpoint -full komutunu kullanın.

Remove-EflowVmSharedFolder

Remove-EflowVmSharedFolder komutu, Windows ana bilgisayar işletim sistemi klasörünü EFLOW sanal makinesiyle paylaşmayı durdurur. Bu komutta iki parametre kullanılır.

Daha fazla bilgi edinmek için Get-Help Remove-EflowVmSharedFolder -full komutunu kullanın.

EflowVM'i ayarlama

Set-EflowVM komutu, sanal makine yapılandırmasını istenen özelliklerle güncelleştirir. Sanal makine için belirli bir yapılandırma tanımlamak için isteğe bağlı parametreleri kullanın.

Daha fazla bilgi edinmek için Get-Help Set-EflowVM -full komutunu kullanın.

Set-EflowVmDNSServers

Set-EflowVmDNSServers komutu, EFLOW sanal makinesi için DNS sunucularını yapılandırıyor.

Daha fazla bilgi edinmek için Get-Help Set-EflowVmDNSServers -full komutunu kullanın.

Set-EflowVmFeature

Set-EflowVmFeature komutu, Windows'da Linux için IoT Edge özelliklerinin durumunu etkinleştirir veya devre dışı bırakır.

Daha fazla bilgi edinmek için Get-Help Set-EflowVmFeature -full komutunu kullanın.

Set-EflowVmTelemetryOption

Set-EflowVmTelemetryOption komutu, sanal makine içinde isteğe bağlı telemetriyi etkinleştirir veya devre dışı bırakır.

Daha fazla bilgi edinmek için Get-Help Set-EflowVmTelemetryOption -full komutunu kullanın.

Start-EflowVm

Start-EflowVm komutu sanal makineyi başlatır. Sanal makine zaten başlatıldıysa hiçbir işlem yapılmaz.

Daha fazla bilgi edinmek için Get-Help Start-EflowVm -full komutunu kullanın.

Stop-EflowVm

Stop-EflowVm komutu sanal makineyi durdurur. Sanal makine zaten durdurulmuşsa hiçbir işlem yapılmaz.

Daha fazla bilgi edinmek için Get-Help Stop-EflowVm -full komutunu kullanın.

Verify-EflowVm

Verify-EflowVm komutu, Windows sanal makinesinde Linux için IoT Edge'in oluşturulup oluşturulmadığını denetleen kullanıma sunulan bir işlevdir. Yalnızca yaygın parametreleri alır ve sanal makine oluşturulduysa True, değilse False döndürür.

Daha fazla bilgi edinmek için Get-Help Verify-EflowVm -full komutunu kullanın.

Sonraki adımlar

Aşağıdaki makalede Windows'da Linux için IoT Edge'i yüklemek ve sağlamak için bu komutları nasıl kullanacağınızı öğrenin:

• Windows'da Linux için Azure IoT Edge'i yükleme