Az IoT Edge PowerShell-függvények Windowson futtatott Linux rendszerhez

Cikk
06/10/2024

A következőkre vonatkozik: IoT Edge 1.5 IoT Edge 1.4

Fontos

Az IoT Edge 1.5 LTS és az IoT Edge 1.4 LTS támogatott kiadások. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Ismerje meg azokat a PowerShell-függvényeket, amelyek windowsos (EFLOW) rendszerű virtuális gépen telepítik, építik ki és kapják meg a Linuxhoz készült IoT Edge állapotát.

Előfeltételek

A cikkben ismertetett parancsok a AzureEFLOW.psm1 fájlból származnak, amely a könyvtárban WindowsPowerShell C:\Program Files\WindowsPowerShell\Modules\AzureEFLOWtalálható a rendszerben.

Ha nem rendelkezik az AzureEflow mappával a PowerShell-címtárban, a következő lépésekkel töltse le és telepítse a Linuxhoz készült Azure IoT Edge-et Windows rendszeren:

Emelt szintű PowerShell-munkamenetben futtassa az alábbi parancsokat a Linuxhoz készült IoT Edge windowsos letöltéséhez.

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

Telepítse az IoT Edge for Linuxot Windows rendszeren az eszközére.
```
Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
```
Egyéni telepítési és VHDX-könyvtárakat úgy adhat meg, hogy hozzáadja INSTALLDIR="<FULLY_QUALIFIED_PATH>" és VHDXDIR="<FULLY_QUALIFIED_PATH>" paramétereket a telepítési parancshoz.
Állítsa be a végrehajtási szabályzatot a céleszközön legalább AllSigned.
```
Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
```

Add-EflowNetwork

Az Add-EflowNetwork parancs új hálózatot ad hozzá az EFLOW virtuális géphez. Ez a parancs két paramétert használ.

Paraméter	Elfogadott értékek	Megjegyzések
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vswitchType	Belső vagy külső	Az EFLOW virtuális géphez rendelt virtuális kapcsoló típusa.

Egy négy tulajdonságot tartalmazó objektumot ad vissza:

Név
AllocationMethod
Cidr
Típus

További információkért használja a parancsot Get-Help Add-EflowNetwork -full.

Add-EflowVmEndpoint

Az Add-EflowVmEndpoint parancs új hálózati végpontot ad hozzá az EFLOW virtuális géphez. Statikus IP-cím beállításához használja az opcionális paramétereket.

Paraméter	Elfogadott értékek	Megjegyzések
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vendpointName	A virtuális végpont neve	Az EFLOW virtuális géphez hozzárendelt virtuális végpont neve.
ip4Address	IPv4-cím a DCHP-kiszolgáló hatókörének tartományában	Az EFLOW virtuális gép statikus Ipv4-címe.
ip4PrefixLength	Az alhálózat IPv4-előtagjának hossza	Az Ipv4-alhálózat előtag hossza csak statikus Ipv4-cím megadásakor érvényes.
ip4GatewayAddress	Az alhálózati átjáró IPv4-címe	Átjáró Ipv4-címe, csak akkor érvényes, ha statikus Ipv4-cím van megadva.

Egy négy tulajdonságot tartalmazó objektumot ad vissza:

Név
MacAddress
HealthStatus
IpConfiguration

További információkért használja a parancsot Get-Help Add-EflowVmEndpoint -full.

Add-EflowVmSharedFolder

Az Add-EflowVmSharedFolder parancs lehetővé teszi egy vagy több Windows gazdagép operációs rendszer mappájának megosztását az EFLOW virtuális géppel.

Paraméter	Elfogadott értékek	Megjegyzések
sharedFoldersJsonPath	Sztring	A megosztott mappák JSON-konfigurációs fájljának elérési útja.

A JSON-konfigurációs fájlnak a következő struktúrával kell rendelkeznie:

sharedFOlderRoot : Az EFLOW virtuális géppel megosztandó összes mappát tartalmazó Windows gyökérmappa elérési útja.
hostFolderPath: Az EFLOW virtuális géppel megosztani kívánt mappa relatív elérési útja (a szülő gyökérmappához).
readOnly: Meghatározza, hogy a megosztott mappa írható vagy írásvédett-e az EFLOW virtuális gépről – Értékek: hamis vagy igaz.
targetFolderOnGuest : Mappa elérési útja az EFLOW virtuális gépen belül, amelyen a Windows gazdagép operációs rendszer mappája csatlakoztatva van.

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

További információkért használja a parancsot Get-Help Add-EflowVmSharedFolder -full.

Connect-EflowVm

A Connect-EflowVm parancs SSH használatával csatlakozik a virtuális géphez. A virtuális gép számára az egyetlen SSH-fiók az, aki létrehozta.

Ez a parancs csak a gazdaeszközön futó PowerShell-munkameneteken működik. Nem fog működni a Windows Felügyeleti központ vagy a PowerShell ISE használatakor.

További információkért használja a parancsot Get-Help Connect-EflowVm -full.

Copy-EflowVmFile

A Copy-EflowVmFile parancs az SCP használatával másolja a fájlt a virtuális gépre vagy onnan. A választható paraméterekkel megadhatja a forrás- és célfájl elérési útját és a másolat irányát.

A felhasználó iotedge-felhasználónak olvasási engedéllyel kell rendelkeznie a forráskönyvtárakhoz, vagy írási engedéllyel kell rendelkeznie a virtuális gép bármely célkönyvtárához.

Paraméter	Elfogadott értékek	Megjegyzések
fromFile	A fájl elérési útját képviselő karakterlánc	Meghatározza a beolvasandó fájlt.
toFile	A fájl elérési útját képviselő karakterlánc	Meghatározza a beírandó fájlt.
pushFile	Egyik sem	Ez a jelző a másolás irányát jelzi. Ha van ilyen, a parancs leküldi a fájlt a virtuális gépre. Ha hiányzik, a parancs lekéri a fájlt a virtuális gépről.

További információkért használja a parancsot Get-Help Copy-EflowVMFile -full.

Deploy-Eflow

A központi telepítési módszer a Deploy-Eflow parancs. Az üzembe helyezési parancs létrehozza a virtuális gépet, kiépít fájlokat, és üzembe helyezi az IoT Edge-ügynökmodult. Bár egyik paraméter sem szükséges, a virtuális gép beállításainak módosítására használhatók a létrehozás során.

Paraméter	Elfogadott értékek	Megjegyzések
acceptEula	Igen vagy Nem	Az EULA elfogadására/elutasítására és az EULA-kérés megkerülésére vonatkozó parancsikon.
acceptOptionalTelemetry	Igen vagy Nem	Parancsikon az opcionális telemetriai adatok elfogadásához/elutasításához, valamint a telemetriai kérés megkerüléséhez.
cpuCount	1 és az eszköz processzormagjai közötti egész szám	A virtuális gép processzormagjainak száma. Alapértelmezett érték: 1 virtuális mag.
memoryInMB	Páros egész szám 1024 és az eszköz szabad memóriájának maximális mennyisége között	A virtuális gép számára lefoglalt memória. Alapértelmezett érték: 1024 MB.
vmDiskSize	21 GB és 2 TB között	A dinamikusan bővülő virtuális merevlemez maximális logikai lemezmérete. Alapértelmezett érték: 29 GB. Megjegyzés: A vmDiskSize vagy a vmDataSize használható, de nem egyszerre.
vmDataSize	2 GB és 2 TB között	Az eredményként kapott merevlemez maximális adatpartíciós mérete GB-ban. Alapértelmezett érték: 10 GB. Megjegyzés: A vmDiskSize vagy a vmDataSize használható, de nem egyszerre.
vmLogSize	Kicsi vagy Nagy	Adja meg a naplópartíció méretét. Kicsi = 1 GB, Nagy = 6 GB. Alapértelmezett érték: Kicsi.
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.
vswitchType	Belső vagy külső	Az EFLOW virtuális géphez rendelt virtuális kapcsoló típusa.
ip4Address	IPv4-cím a DCHP-kiszolgáló hatókörének tartományában	Az EFLOW virtuális gép statikus Ipv4-címe.
ip4PrefixLength	Az alhálózat IPv4-előtagjának hossza	Az Ipv4-alhálózat előtag hossza csak statikus Ipv4-cím megadásakor érvényes.
ip4GatewayAddress	Az alhálózati átjáró IPv4-címe	Átjáró Ipv4-címe, csak akkor érvényes, ha statikus Ipv4-cím van megadva.
gpuName	GPU-eszköz neve	Az átengedéshez használandó GPU-eszköz neve.
gpuPassthroughType	DirectDeviceAssignment, ParaVirtualization vagy none (csak CPU)	GPU-átengedés típusa
gpuCount	1 és az eszköz GPU-magjainak száma közötti egész szám	A virtuális gép GPU-eszközeinek száma. Megjegyzés: ParaVirtualization használata esetén mindenképpen állítsa be a gpuCount = 1 értéket
customSsh	Egyik sem	Meghatározza, hogy a felhasználó szeretné-e használni az egyéni OpenSSH.Client-telepítést. Ha van ilyen, ssh.exe elérhetőnek kell lennie az EFLOW PSM számára
sharedFoldersJsonPath	Sztring	A megosztott mappák JSON-konfigurációs fájljának elérési útja.

További információkért használja a parancsot Get-Help Deploy-Eflow -full.

Get-EflowHostConfiguration

A Get-EflowHostConfiguration parancs visszaadja a gazdagép konfigurációját. Ez a parancs nem vesz fel paramétereket. Egy négy tulajdonságot tartalmazó objektumot ad vissza:

FreePhysicalMemoryInMB
NumberOfLogicalProcessors
DiskInfo
GpuInfo

További információkért használja a parancsot Get-Help Get-EflowHostConfiguration -full.

Get-EflowLogs

A Get-EflowLogs parancs összegyűjti és csomagolja a naplókat a Linuxhoz készült IoT Edge-ből Windows-telepítés és -telepítés esetén. A csomagban lévő naplókat mappa formájában .zip adja ki.

További információkért használja a parancsot Get-Help Get-EflowLogs -full.

Get-EflowNetwork

A Get-EflowNetwork parancs az EFLOW virtuális géphez rendelt hálózatok listáját adja vissza. Egy adott hálózat lekéréséhez használja az opcionális paramétert.

Paraméter	Elfogadott értékek	Megjegyzések
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

Négy tulajdonságot tartalmazó objektumlistát ad vissza:

Név
AllocationMethod
Cidr
Típus

További információkért használja a parancsot Get-Help Get-EflowNetwork -full.

Get-EflowVm

A Get-EflowVm parancs visszaadja a virtuális gép aktuális konfigurációját. Ez a parancs nem vesz fel paramétereket. Egy négy tulajdonságot tartalmazó objektumot ad vissza:

VmConfiguration
VmPowerState
EdgeRuntimeVersion
EdgeRuntimeStatus
SystemStatistics

Ha egy adott tulajdonságot egy olvasható listában szeretne megtekinteni, futtassa a Get-EflowVM parancsot a kibontott tulajdonsággal. Példa:

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

További információkért használja a parancsot Get-Help Get-EflowVm -full.

Get-EflowVmAddr

A Get-EflowVmAddr paranccsal lekérdezhető a virtuális gép aktuális IP- és MAC-címe. Ez a parancs azért létezik, hogy figyelembe vehesse azt a tényt, hogy az IP- és MAC-cím idővel változhat.

További információkért használja a parancsot Get-Help Get-EflowVmAddr -full.

Get-EflowVmEndpoint

A Get-EflowVmEndpoint parancs az EFLOW virtuális géphez rendelt hálózati végpontok listáját adja vissza. Az opcionális paraméterrel lekérhet egy adott hálózati végpontot.

Paraméter	Elfogadott értékek	Megjegyzések
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

Négy tulajdonságot tartalmazó objektumlistát ad vissza:

Név
MacAddress
HealthStatus
IpConfiguration

További információkért használja a parancsot Get-Help Get-EflowVmEndpoint -full.

Get-EflowVmFeature

A Get-EflowVmFeature parancs a Linuxhoz készült IoT Edge windowsos funkcióinak engedélyezésének állapotát adja vissza.

Paraméter	Elfogadott értékek	Megjegyzések
funkció	DpsTpm	A lekérdezéshez szükséges szolgáltatásnév.

További információkért használja a parancsot Get-Help Get-EflowVmFeature -full.

Get-EflowVmName

A Get-EflowVmName parancs a virtuális gép aktuális állomásnevét adja vissza. Ez a parancs azt a tényt szeretné figyelembe venni, hogy a Windows-állomásnév idővel változhat.

További információkért használja a parancsot Get-Help Get-EflowVmName -full.

Get-EflowVmSharedFolder

A Get-EflowVmSharedFolder parancs egy vagy több, az EFLOW virtuális géppel megosztott Windows-gazdagép operációsrendszer-mappájával kapcsolatos információt ad vissza.

Paraméter	Elfogadott értékek	Megjegyzések
sharedfolderRoot	Sztring	A Windows gazdagép operációs rendszer megosztott gyökérmappájának elérési útja.
hostFolderPath	Sztring vagy lista	A Windows gazdagép operációs rendszer megosztott mappájának/mappáinak relatív elérési útjai (a gyökérmappához).

Három tulajdonságot tartalmazó objektumlistát ad vissza:

hostFolderPath: Az EFLOW virtuális géppel megosztott mappa relatív elérési útja (a szülő gyökérmappához).
readOnly: Meghatározza, hogy a megosztott mappa írható vagy írásvédett-e az EFLOW virtuális gépről – Értékek: hamis vagy igaz.
targetFolderOnGuest: Mappa elérési útja az EFLOW virtuális gépen belül, amelyen a Windows mappa csatlakoztatva van.

További információkért használja a parancsot Get-Help Get-EflowVmSharedFolder -full.

Get-EflowVmTelemetryOption

A Get-EflowVmTelemetryOption parancs megjeleníti a telemetria állapotát (opcionális vagy kötelező) a virtuális gépen belül.

További információkért használja a parancsot Get-Help Get-EflowVmTelemetryOption -full.

Get-EflowVmTpmProvisioningInfo

A Get-EflowVmTpmProvisioningInfo parancs a TPM kiépítési adatait adja vissza. Ez a parancs nem vesz fel paramétereket. Két tulajdonságot tartalmazó objektumot ad vissza:

Ellenőrzőkulcs
Regisztráció azonosítója

További információkért használja a parancsot Get-Help Get-EflowVmTpmProvisioningInfo -full.

Invoke-EflowVmCommand

Az Invoke-EflowVMCommand parancs végrehajt egy Linux-parancsot a virtuális gépen belül, és visszaadja a kimenetet. Ez a parancs csak olyan Linux-parancsok esetén működik, amelyek véges kimenetet adnak vissza. Nem használható olyan Linux-parancsokhoz, amelyek felhasználói beavatkozást igényelnek, vagy határozatlan ideig futnak.

A parancs előre történő megadásához az alábbi választható paraméterek használhatók.

Paraméter	Elfogadott értékek	Megjegyzések
command	Sztring	A virtuális gépen végrehajtandó parancs.
ignoreError	Egyik sem	Ha ez a jelző jelen van, hagyja figyelmen kívül a parancs hibáit.

További információkért használja a parancsot Get-Help Invoke-EflowVmCommand -full.

Provision-EflowVm

A Provision-EflowVm parancs hozzáadja az IoT Edge-eszköz kiépítési adatait a virtuális gép IoT Edge-fájljához config.yaml .

Paraméter	Elfogadott értékek	Megjegyzések
provisioningType	ManualConnectionString, ManualX509, DpsTPM, DpsX509 vagy DpsSymmetricKey	Meghatározza az IoT Edge-eszközhöz használni kívánt kiépítés típusát.
devConnString	Meglévő IoT Edge-eszköz kapcsolati sztring eszköz	Eszköz kapcsolati sztring IoT Edge-eszköz manuális kiépítéséhez (ManualConnectionString).
iotHubHostname	Meglévő IoT Hub gazdagépneve	Az Azure IoT Hub gazdagépneve IoT Edge-eszköz (ManualX509) kiépítéséhez.
deviceId	Meglévő IoT Edge-eszköz eszközazonosítója	Eszközazonosító IoT Edge-eszköz kiépítéséhez (ManualX509).
scopeId	Egy meglévő DPS-példány hatókörazonosítója.	Hatókörazonosító IoT Edge-eszköz (DpsTPM, DpsX509 vagy DpsSymmetricKey) kiépítéséhez.
symmKey	Egy meglévő DPS-regisztráció elsődleges kulcsa vagy egy szimmetrikus kulcsokkal regisztrált meglévő IoT Edge-eszköz elsődleges kulcsa	Szimmetrikus kulcs egy IoT Edge-eszköz (DpsSymmetricKey) kiépítéséhez.
registrationId	Meglévő IoT Edge-eszköz regisztrációs azonosítója	Regisztrációs azonosító egy IoT Edge-eszköz kiépítéséhez (DpsSymmetricKey, DpsTPM).
identityCertPath	Címtár útvonala	Az identitástanúsítvány abszolút célútvonala a Windows-gazdagépen (ManualX509, DpsX509).
identityPrivKeyPath	Címtár útvonala	Az identitás titkos kulcsának abszolút forrásútvonala a Windows-gazdagépen (ManualX509, DpsX509).
globalEndpoint	Eszközvégpont URL-címe	A DPS kiépítéséhez használandó globális végpont URL-címe.

További információkért használja a parancsot Get-Help Provision-EflowVm -full.

Remove-EflowNetwork

A Remove-EflowNetwork parancs eltávolítja az EFLOW virtuális géphez csatlakoztatott meglévő hálózatot. Ez a parancs egy paramétert vesz igénybe.

Paraméter	Elfogadott értékek	Megjegyzések
vswitchName	A virtuális kapcsoló neve	Az EFLOW virtuális géphez rendelt virtuális kapcsoló neve.

További információkért használja a parancsot Get-Help Remove-EflowNetwork -full.

Remove-EflowVmEndpoint

A Remove-EflowVmEndpoint parancs eltávolítja az EFLOW virtuális géphez csatlakoztatott meglévő hálózati végpontot. Ez a parancs egy paramétert vesz igénybe.

Paraméter	Elfogadott értékek	Megjegyzések
vendpointName	A virtuális végpont neve	Az EFLOW virtuális géphez hozzárendelt virtuális végpont neve.

További információkért használja a parancsot Get-Help Remove-EflowVmEndpoint -full.

Remove-EflowVmSharedFolder

A Remove-EflowVmSharedFolder parancs leállítja a Windows gazdagép operációs rendszer mappájának megosztását az EFLOW virtuális gépen. Ez a parancs két paramétert használ.

Paraméter	Elfogadott értékek	Megjegyzések
sharedfolderRoot	Sztring	A Windows gazdagép operációs rendszer megosztott gyökérmappájának elérési útja.
hostFolderPath	Sztring vagy lista	A Windows gazdagép operációs rendszer megosztott mappájának/mappáinak relatív elérési útjai (a gyökérmappához).

További információkért használja a parancsot Get-Help Remove-EflowVmSharedFolder -full.

Set-EflowVM

A Set-EflowVM parancs frissíti a virtuális gép konfigurációját a kért tulajdonságokkal. Az opcionális paraméterekkel definiálhat egy adott konfigurációt a virtuális géphez.

Paraméter	Elfogadott értékek	Megjegyzések
cpuCount	1 és az eszköz processzormagjai közötti egész szám	A virtuális gép processzormagjainak száma.
memoryInMB	1024 és az eszköz szabad memóriájának maximális mennyisége közötti egész szám	A virtuális gép számára lefoglalt memória.
gpuName	GPU-eszköz neve	Az átengedéshez használandó GPU-eszköz neve.
gpuPassthroughType	DirectDeviceAssignment, ParaVirtualization vagy none (nincs átengedés)	GPU-átengedés típusa
gpuCount	1 és az eszköz GPU-magjai közötti egész szám	A virtuális gép GPU-eszközeinek száma megjegyzés: Csak a DirectDeviceAssignment használatakor érvényes
fejetlen	Egyik sem	Ha ez a jelző jelen van, meghatározza, hogy a felhasználónak meg kell-e erősítenie, ha biztonsági figyelmeztetést adnak ki.

További információkért használja a parancsot Get-Help Set-EflowVM -full.

Set-EflowVmDNSServers

A Set-EflowVmDNSServers parancs konfigurálja az EFLOW virtuális gép DNS-kiszolgálóit.

Paraméter	Elfogadott értékek	Megjegyzések
vendpointName	A virtuális végpont nevének sztringértéke	A Get-EflowVmEndpoint használatával szerezze be az EFLOW virtuális géphez rendelt virtuális adaptereket. Pl. DESKTOP-CONTOSO-EflowInterface
dnsServers	A névfeloldáshoz használandó DNS-kiszolgáló IPAddress listája	Pl. @("10.0.10.1")

További információkért használja a parancsot Get-Help Set-EflowVmDNSServers -full.

Set-EflowVmFeature

A Set-EflowVmFeature parancs engedélyezi vagy letiltja a Linuxhoz készült IoT Edge állapotát Windows-funkciókon.

Paraméter	Elfogadott értékek	Megjegyzések
funkció	DpsTpm, Defender	A funkció neve váltógomb.
engedélyez	Egyik sem	Ha ez a jelző jelen van, a parancs engedélyezi a funkciót.

További információkért használja a parancsot Get-Help Set-EflowVmFeature -full.

Set-EflowVmTelemetryOption

A Set-EflowVmTelemetryOption parancs engedélyezi vagy letiltja az opcionális telemetriát a virtuális gépen belül.

Paraméter	Elfogadott értékek	Megjegyzések
optionalTelemetry	Igaz vagy hamis	A választható telemetria kiválasztása.

További információkért használja a parancsot Get-Help Set-EflowVmTelemetryOption -full.

Start-EflowVm

A Start-EflowVm parancs elindítja a virtuális gépet. Ha a virtuális gép már elindult, a rendszer nem hajt végre műveletet.

További információkért használja a parancsot Get-Help Start-EflowVm -full.

Stop-EflowVm

A Stop-EflowVm parancs leállítja a virtuális gépet. Ha a virtuális gép már le van állítva, a rendszer nem hajt végre műveletet.

További információkért használja a parancsot Get-Help Stop-EflowVm -full.

Verify-EflowVm

A Verify-EflowVm parancs egy közzétett függvény, amely ellenőrzi, hogy létrejött-e a Linuxhoz készült IoT Edge Windows rendszerű virtuális gépen. Csak a gyakori paramétereket veszi igénybe, és igaz értéket ad vissza, ha a virtuális gép létrejött, és hamis, ha nem.

További információkért használja a parancsot Get-Help Verify-EflowVm -full.

Következő lépések

Az alábbi cikkben megtudhatja, hogyan telepítheti és építheti ki a Linuxhoz készült IoT Edge-et Windows rendszeren az alábbi parancsokkal:

A Linuxhoz készült Azure IoT Edge telepítése Windows rendszeren

Megosztás a következőn keresztül: