Egyéni függvények használata

Érintett szolgáltatás:

• Microsoft Defender XDR

Fontos

Bizonyos információk az előzetesen forgalomba hozott termékre vonatkoznak, amely a kereskedelmi forgalomba kerülés előtt lényegesen módosulhat. A Microsoft nem vállal semmilyen, kifejezett vagy vélelmezett jótállást az itt megadott információkra vonatkozóan.

A függvények típusai

A függvény olyan lekérdezéstípus a speciális veszélyforrás-keresésben, amely más lekérdezésekben is használható, mintha parancs lenne. Létrehozhat saját egyéni függvényeket, hogy a környezetben való kereséskor újra felhasználhassa a lekérdezési logikát.

A speciális veszélyforrás-keresésben három különböző típusú függvény létezik:

• Beépített függvények – Előre összeállított függvények Microsoft Defender XDR speciális veszélyforrás-kereséshez. Ezek minden speciális veszélyforrás-keresési példányban elérhetők, és nem módosíthatók.
• Megosztott függvények – A felhasználók által létrehozott egyéni függvények, amelyek egy adott bérlő összes felhasználója számára elérhetők, és a felhasználók módosíthatják és vezérelhetik őket.
• Saját függvények – A felhasználó által létrehozott egyéni függvények, amelyeket csak az azt létrehozó felhasználó tekinthet meg és módosíthat.

Saját egyéni függvény írása

Ha a szerkesztőben az aktuális lekérdezésből szeretne függvényt létrehozni, válassza a Mentés , majd a Mentés függvényként lehetőséget.

Ezután adja meg a következő információkat:

• Name – A függvény neve. Csak számokat, angol betűket és aláhúzásjeleket tartalmazhat. Ha el szeretné kerülni a Kusto-kulcsszavak véletlen használatát, kezdje vagy fejezheti be a függvényneveket aláhúzásjellel vagy nagybetűvel.

• Location (Hely ) – Az a mappa, amelybe menteni szeretné a függvényt, akár megosztott, akár privát.

• Leírás – Olyan leírás, amely segíthet más felhasználóknak megérteni a függvény célját és működését.

• Paraméterek – Adjon hozzá egy paramétert a függvény minden olyan változója számára, amely a használat során értéket igényel. Adjon hozzá paramétereket egy függvényhez, hogy meg tudja adni bizonyos változók argumentumait vagy értékeit a függvény meghívásakor. Ez lehetővé teszi, hogy ugyanazt a függvényt különböző lekérdezésekben használjuk, amelyek mindegyike különböző értékeket tesz lehetővé a paraméterek számára. A paramétereket a következő tulajdonságok határozzák meg:

  • Type – Az érték adattípusa
  • Name – Az a név, amelyet a lekérdezésben használni kell a paraméter értékének cseréjéhez
  • Alapértelmezett érték – A paraméterhez használandó érték, ha nincs megadva érték

  A paraméterek a létrehozásuk sorrendjében jelennek meg, az alapértelmezett értékkel nem rendelkező paraméterek pedig az alapértelmezett értékkel rendelkeznek.

Egyéni függvény használata

Használjon függvényt egy lekérdezésben úgy, hogy beírja a nevét és a paraméterek értékeit, ugyanúgy, mint egy parancsban. A függvény kimenete visszaadható eredményként, vagy átirányítható egy másik parancsba.

Adjon hozzá egy függvényt az aktuális lekérdezéshez. Ehhez kattintson duplán a nevére, vagy válassza a függvény jobb oldalán található három elemet, és válassza a Megnyitás a lekérdezésszerkesztőben lehetőséget.

Ha egy lekérdezés argumentumokat igényel, adja meg őket a következő szintaxissal: function_name(1. paraméter, 2. paraméter, ...)

Megjegyzés:

A függvények nem használhatók egy másik függvényen belül.

Függvénykódok használata

A függvény kódját megtekintheti, hogy betekintést nyerjen a működésébe, vagy módosítsa annak kódját. Kattintson a függvény jobb oldalán található három pontra, és válassza a Függvénykód betöltése lehetőséget egy új lap megnyitásához a függvénykóddal.

Egyéni függvény szerkesztése

A függvény tulajdonságainak szerkesztéséhez kattintson a függvény jobb oldalán található három pontra, és válassza a Részletek szerkesztése lehetőséget. Módosítsa a függvény tulajdonságait és paramétereit, majd válassza a Mentés lehetőséget.

Ha a függvénykód már be van töltve a szerkesztőbe, a Save ( Mentés ) gombra kattintva bármilyen módosítást alkalmazhat a függvény kódjára vagy tulajdonságaira.

Megjegyzés:

Ha egy függvény már használatban van egy mentett lekérdezésben vagy észlelési szabályban, nem szerkesztheti a függvényt a hatókörének kibontásához. Ha például olyan függvényt mentett, amely lekérdezi az identitástáblákat, és ezt a függvényt egy észlelési szabály használja, a függvény nem szerkeszthető úgy, hogy a tény után eszköztáblát is tartalmazzon. Ehhez menthet egy új függvényt. A termék hatókörkezelése szűkíthető ugyanahhoz a függvényhez, de nem bővíthető ki.

Egyéni függvény törlése

A megosztott függvényekben létrehozott Saját függvények és függvények közül törölheti a függvényeket. Nem törölheti a nem létrehozott függvényeket, hacsak nem rendelkezik biztonsági adatok kezelésére vonatkozó engedélyekkel.

Egy függvény törléséhez kattintson a függvény jobb oldalán található három pontra, majd válassza a Törlés lehetőséget.

Lásd még

• Speciális veszélyforrás-keresés áttekintése
• Lekérdezés nyelvének megismerése
• A séma értelmezése
• További lekérdezési példák lekérése

Tipp

Szeretne többet megtudni? Lépjen kapcsolatba a Microsoft biztonsági közösségével a technikai közösségünkben: Microsoft Defender XDR Tech Community.