Home

Network Monitor API

1. 65 GetHeaderContentTransferEncoding ran nn 65 239 16806 500 168 nunnan nanuka nannaa 65 CATS TI 65 239 1 8 6 00 16 0 nono anenun cnn nn 66 GetHe aden ate ess cs eis cise 66 Getkleadet EXP e Sunani Seth oc iii 66 GetHe derhHost 2 2 22 a a cho AT 66 TLuaHTTPClient Script de ejemplo TLuaHTTPClient Script to download a html page from a web server http TLuaHTTPClient Connect using the default parameters iRet http Connect if iRet 0 then Make a GET request to default document iRet http Get Print returned code from HTTP server prime Codes Y iRST Extract content length iRet http GetHeaderContentLength print Content length iRet Dieimie COMESmic string iRet http GetContent iRet print string Print raw headers string http GetHeadersRaw prime SAA A a Dolo Print COOKIES string http GetHeaderCookies prime Cookies n Stig Extract and print cookies one by one iNumber http GetHeaderCookieCount for count
2. 20 LuaScriptConfigurator Script de ejemplo OnConfigure function OnConfigure The variable returned must be called Config so KNM can find it Config LuaScriptConfigurator 1 S ANNEINEN e Config SetAuthor My name Description Config SetDescription Description of the script including usage parameters etc Minimum build version of KNM set to zero for if no specificbuild version is required Config SetMinBuildVersion 0 Script version major minor Config SetScriptVersion 1 0 A parameter configuration add them in the order the script is extracting them Config AddArgument Argument 1 This is the description of thefirst argument LuaScriptConfigurator CHECK NOT EMPTY Add another parameter a select box with 3 values Config AddArgument Argument 2 This is the description of thesecond argument LuaScriptConfigurator CHECK NOT EMPTY LuaScriptConfigurator ENUM AVIL Set the entry point this is the function called by KNM Config SetEntryPoint main Done with configuration return the asset return Config end AddArgument int AddArgument string sName string sDescription int iFlags Valores de devoluci n Un identificador que se puede utilizar para referirse a este argumento en llamadas subsiguientes Par metros sName nombre del campo de argumento sDesc d
3. CON jist fet Ati a a GetHeaderContentLength 5 cr GetHeaderContentIyDe viii ii Ba 39 19806 0 16 1 8 8 606 0 Get eader Cookies iii ada Dd ES da dic T asa GeihleaderCookies acc oia iia en nike GetHeaderCookicCounts 221 GeiheaderDate sis rhc 28 hee att es Beehive AO eee at aes eee es GetHeaderExpiressn nnn ee ae 1911611091 ne aw he aed AGS ahaa faa TLualCMP Seriptae ejemplo TEUalEMP 4 542424 keller ei A ei bern NN TLualCMPPingResult TLualCMPTraceResult TLuaPowershell Script de ejemplo TLuaPowersh ell ooonoconnnccnnncnnnnnconncccnn oca nc n crac Script de ejemplo TLuaPowershell Windows SCripting 2 cccccceseeceeseeceeeeeeeaeeeeeaeeeeeeeseeeesaeeseaeeeenees A Execute amp ommand irn en Sie BE ei GetStdOut stn ast dl silt
4. 10 SCIEXItS talus ad 10 SEtEASTEMO a e As le eae 10 StoreStatisticalData A aA 11 storestatisticalData 5 11 Walt A te 14 LuaScriptEnumResult 15 Script de ejemplo OnEnumerate 440u4s44004nsonnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannn 16 AQKOQ Misa rara dead 16 LuaScriptConfigurator 17 Script de ejemplo OnConfigure 1 18 5 Beenie ds Ad a a id a La coat 18 SetCharacterLimits rau ised city A Leite eet 19 SeiNumerichimits st seeded aires RR IDEE 19 SEEM POMO 19 SOTA UNO day a AAA a 20 SEIDESCriPllON 20 SeiMinBuild Version ie 20 21 15 15 81016 116 8 5
5. E CET ENTE 32 GetColl AsD ate Time ai 222s leide 32 111910 188 110 1 8 E e ert cost creer eee 33 GetErrorDescripti0N cia is iaa 33 INQ 41810 nhac ba Jaana bake ci A a 33 TLuaDB Script d Create new D TLuaD DB eommeeie DB Connect DSN testdsn TLuaDB CLI Aue Insert bok Select bok 2115 N UCoOlCotine WCOULWYIOS 67 Decas e ejemplo TLuaDB B asset B 6 cay oN then NODE SUE a few rows Becta insert into test DB all rows in table DB Execute select from test bok true then Check if we got rows back if DB ResultAvilable tru 11D sTest values 10 test then Print how many columns WC OLCoum DECO TEE Gate Fiese wow while DB NextRow 11 11691 9 1 10 1 11 902 0 1 GetColType iColType D sData perme Col AS Dalia end end end else end else Print error and exit SetExitStatus Failed Print error and exit Set end neltestatcus MEalled to conmece D ColCount int ColCount Valores de devoluci n true DB Get B Get
6. 6111211121 2 22 Gai lt GetErrorDescription y tisie er ne GetErr rGode TLuaRegistry ENUMVAlU ei fo ct te ete ee ct ates teal celal ee EN AET E ea dla dicen kid rate GetErrorDESeription user te DV ees NER A NET Se tad ee acess ees ee ee ee Eee ie Read ll Eee Se A oia PROC IC ress ee iaa Eee ee Seal 2 0 52 2 2 5 22 e Eee trae cit SELVA Le EIEEE ER LEE TER AAN RA SetValueExXpandedStINd cias ali ar a airada TLuaSFTPClient A O AR NO Open Forrest orita pra ltd cda E rata 7 910111 61 o a 1 11 ce co bese soe cee 91 Remove E ei le ee er en en essen udn Era lasse ra e BE SE 92 BLEI OIN A
7. 115 tei IRRE o 115 113 TLuaSocket Script de ejemplo TLuaSocket Construct a new socket device socket TLuaSocket iPortNumber 8080 Open a TCP socket iRet socket OpenTCP iPortNumber If OpenTCP returned a 0 boolean FALSE then the open failed if iRet 0 then print Cannot open port iPortNumber Error code GetlastError else Read some data max 1024 bytes from the socket iReadSize 1024 data socket Read iReadSize Print the content if iReadSize gt 0 then print Data received from server n n print data else print No data received from server end end socket Close Cerrar int Close Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Comentarios Cierra el socket abierto anteriormente con OpenTCP u OpenUDP OpenTCP int OpenTCP int Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError 114 TLuaSocket Par metros iPort el puerto por abrir Comentarios Abre un socket TCP con el numero de puerto es
8. dl 119 A A TIL 119 IR ST EEA E EEE PE A E E E E LTE TE 120 ESC dat ostia att 120 GetGerlificateEXpiry Date ios ot tdi 120 TLuaStorage 121 Greatelte mst A A tas 122 Updateltem sca o N ei 122 Pelete ko 2 ad en 122 A A Pied la ren 123 1L03Storageltem 4 I ene 123 TLuaTimer 125 Script de ejemplo TLuaTimer driisda ad iiai e i ai iia 126 Lia o AEAEE EE EA TOETA E AE EEE E E EE E choline T 126 Detener to EEE EEEN PE E dalt 126 TLuaWinperf 127 Script de ejemplo TLuaWinperf ronca cnn 128 GetErrorDeseription a A ce A ee eed Na 128 GetResult a sine een Al ae Be ee 128 QUE AAA Mate eh ee 128 TLuaWMIQuery 129 TLUAWIMIQUEY ale i A ee a 130 JO CUTAN Aue eer vilees 130 GetErrorDeseription sis vse teen avid Ae 130 SL A ae atest delaras 130 NO XtINSTANCO 8
9. 134 GetP rentNodere A an schwanz 134 NEE A tse 135 TLuaXMLNode FindAttribute string FindAttribute string sName Valores de devoluci n La funci n devuelve una cadena con el valor del atributo Si no se puede encontrar el atributo la cadena que se devuelve est vac a Par metros sName el nombre del atributo FindChildNode TLuaXMLNode FindChildNode string sElementName int iOffset Valores de devoluci n Si se encuentra el elemento la funci n devuelve un activo TLuaXMLNode v lido Par metros sElementName el nombre del elemento secundario para este nodo iOffset un indice de base cero para recuperar elementos secundarios con el mismo nombre en el nodo Comentarios Esta funci n se puede usar para iterar en una cantidad de elementos secundarios con el mismo nombre Aumente el par metro de desplazamiento para recuperar el siguiente elemento GetData string GetData Valores de devoluci n La funci n devuelve los datos en el elemento GetTag string GetTag Valores de devoluci n La funci n devuelve el nombre de etiqueta del elemento GetParentNode TLuaXMLNode GetParentNode 134 TLuaXMLNode Valores de devoluci n La funci n devuelve el elemento primario del elem
10. 47 GETFMESIZE ann anerkennen 48 GetFileSizeMB 48 GetFileStatU a Dz 48 MOVE FIG ice on E E E 2255855555 228 49 Ae 49 Loros 49 Read Datta id 50 REMAMEGFIC oia aii 50 SeekFromGCurTeNt ccccccnonncnccnnnonononononanocononononnnnnnnncnnnnnnnnnnnnnnnn nono anna arcano none anar aran canaria 50 SeekFromEnd iia 51 Seek MS raid 51 ES ada acia cai 51 41 TLuaFile 42 TLuaFile Scripts de muestra TLuaFile Ejemplo 1 Script creates a new text file writes a string to it and close it file TLuaFile Open a text file 5 Wes y crost te ewe Check if it could be created it might exist and be write protected if iRet 0 then 1 1 1 1 01 0 556 0112069591 SetExitStatus sErrString false else prime 661 iia Write a string to the file sString Hello world file Write sString string len sString SOS the ule filesCilose Serisi scacts Teste Ok tenue end Ejemplo 2 Script demonstrates File enumration Directory enumration Create and delete a directory Construct a new file devic file TLuaFile the directory seems for file using the walleleamal RSS Eee Seele Yes eejo ae print sResult Scans the directory c temp for sub directories
11. rca 82 GOV A arcs Seas AT 62 61 21 62 Delete ValUe ococonoccnccccoconononoccnccnnononenanancnnno nono nana nnnnnn nono nena ran cn nono nena anna cnn nn nn nnanccnnnacnnnnns 83 ENuUMV alUC ccccccccnonoccnccnnononononoccncnnnonononono conc nono non anna nn 5 63 GetErrorDescription 63 OT 84 ReadValU8 ccccccccnonccccccncononononoccncnnnononononannnnnn nono nn anna anna conocen aran anna nn 84 ReadVAalUE ccccccccnonocccccncononononoccnccnnononononannnnnn nana nn nena nn 64 ReadVAalU8 ccccccccnonocccccnnononononoccncnnnononononancnnnn nono naar nena anna rca 65 SOIVQlU8 LOAA E A E 65 SetValue 66 SetValue narnia 66 SetValueExpandedString cnn nn 86 81 TLuaRegistry Script de ejemplo TLuaRegistry Demonstrates the Lua Windows Registry interface Open the registry on the host determined by the current context Reg TLuaRegistry if Reg O
12. if sftp Connect username password false then SetExitStatus No respons false SEVA end Create a directory handle and open the current directory hHandle TLuaSFTPClientDirectoryHandle bok sftp OpenDir hHandle if true then List the directory bok sftp ListDir hHandle if bok false then SetExitStatus Cannot list directory false sftp CloseDir hHandle return end Loop over th ntries in the directory File TLuaSFTPClientFile while hHandle Next File false do Prine as file meme paa Filem srileneme end end Close handle sftp CloseDir hHandle Cerrar bool Close TLuaSFTPClientHandle FileHandle Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros FileHandle identificador del archivo abierto anteriormente CloseDir bool CloseDir TLuaSFTPClientDirectoryHandle Handle 88 TLuaSFTPClient Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso En una operaci n satisfactoria se cierra el identificador TLuaSFTPClientDirectoryHandle Par metros Handle identificador abierto por la funci n OpenDir Conectar bool Connect const unsigned int iPort 22 const unsigned short dwTimeout 25000 Valor de devoluci n Devuelve un resultado verdadero si la operaci
13. 20 TLuaDateTime 23 AEGA sce RL E 24 CO AM as el a aan Adee 24 CHEATS SPA ut 0 A cave eds 24 A ak ements E EIEN TENE a TE Sua EEE e a 6 11 1141 a GPO ater ecient O O GrealerOrEqual mi a 1 o o rrr EESSOrE Qual 19111918 11 2 8 baat ae Establecer er o TLuaDB script de ejemplox PLuaDBes is sec aston a OIG OU T A A
14. ALTE ALS te Rn fee 104 A 1 ae ST 105 Elo a er o 105 Wake nee Meet cate 106 TEUASNMPRESUlt2 8 4 22 3342 ralla dll llei a 106 TLuaSSH2Client 109 Script de ejemplo 1 1 85542 5 6 110 EXECULEGOMMANG ars er ia 110 GeIErr rDeseripti n tii a need een adenda cial ad ada 110 Cl NA 110 Ge tS IQ Ob ices tn 22 2 222952 02 522292 252222 22 2 110 A TN 111 TLuaSocket 113 Script de ejemplo TLuaSocket 114 GON ES 9 te a de etna A aati tet ee ee 114 PONS Prise pe iia 114 OpenUDP ieot bat 115 EEE EE ee 52 e 115 4 1618161 16 75 85877 elsa 115 TLuaSocketSecure 117 15 161861 9 988 10 19 6 0 1 16 1 899996 116 Po
15. Enter the username and password for the session sUsername myusername sPassword mypassword Connect to FTP server using username and password iRet ftp Connect sUsername sPassword 21 Check return value from server if iRet then Failed to connect print why iRet GetLastError sErrorString FormatErrorString iRet sErrString Error when connecting to FTP server error sErrorString SetExitStatus sErrString false 8 else Open a file on the FTP server that we know exist sFilename update vcf Open file do not create it use text mode iRet ftp OpenFile sFilename false true if iRet 0 then sErrString Cannot open file sFilename SetExitStatus sErrString false else iMaxSize 1024 16 Read a number of bytes from the file Note here that we are using the special lua return value convention Read returns one string and the size of the string sFilecontent iMaxSize ftp Read iMaxSize print Size Sr Comicaaces Wo Mer Size NAD print sFilecontent Close file so we can open a new file later or close the session ftp CloseFile SetExitStatus Test ok true end end Close FTP session ftp Close ChangeDirectory int ChangeDirectory string sDir Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se p
16. 5 31 OID que representa el comienzo de un examen del rbol de OID Ejemplo de OID iso org dod internet mgmt mib 2 interfaces ifT able Comentarios Antes de la primera invocaci n de la funci n Walk el programa debe invocar la funci n BeginWalk para establecer el comienzo de Walk Walk recupera todos los identificadores de activos secundarios y del mismo nivel del OID inicial establecidos por las funciones BeginWalk Cerrar Close Comentarios Cierra la conexi n SNMP Get string Get string sOID int iSyntax Valores de devoluci n Una cadena con el valor obtenido del agente SNMP remoto 104 TLuaSNMP Par metros sOID OID para usar en la operaci n Get Cuando se consulta una interfaz se puede utilizar el usuario para especificar el indice de interfaz Ejemplo del uso del usuario 0 iso org dod internet mgmt mib 2 interfaces ifTable ifEntry ifInOctets NV IDIA nForce Networking Controller Ejemplo del OID normal iso org dod internet mgmt mib 2 interfaces ifTable ifEntry ifInOctets 1 iSyntax especifica el formato de los datos devueltos Puede ser una de las siguientes constantes SNMP_NOSYNTAX SNMP_IPADDRESS SNMP_INTEGER SNMP_UNSIGNED32 SNMP_COUNTER32 SNMP_GAUGE32 SNMP_TIMETICKS SNMP_OPAQUE SNMP_OCTETSTRING SNMP_DATA_AS_HEXSTRING Lectura de valores binarios Algunos OID pueden devolver datos binarios en lugar de por ejemplo una cadena o un entero Esto puede
17. E a E A A a ETR AS Date TIMES SI 670 ER ol cmc er treet ce ree GetErtorDesScriptio 485179 geese NEXT We eich Ate Aes ie ir IN ResultAvilable sni n a E II TLuaDNS Seript de ejempI6 TLUADNS 2 COM 1 2 ls a GEIEFLOHDESEHIPIION He an a re Siguiente SEE a a u REEL QUEM rere a e TEVUaBNS AR amp cdrdi awe eset adh u a Teua DNS CGNAMERGCOrd A ec AN ee en A Is TLUADNS MARCO iii O A RI IE ee ei TLUAaDNS NSRecord a O AAA en Ae ee TLUADNS PT RRECOMrd H aii el ee ee ei TLUADNS sS OAReCord iissn ar A eee A EL eee its TLUADNS TXT RECOM iis neat O A hee eit TLuaFile COPY O acia tada ad F
18. hace a dard 99 TLuaSFTPClientDirectoryHandle Siguiente bool Next TLuaSFTPClientFile amp hFile Valor de devoluci n Devuelve un resultado verdadero si la funci n TLuaSFTPClientFile proporcionada contiene datos Comentarios Repita la funci n hasta que devuelva un resultado falso para recuperar toda la informaci n devuelta por la funci n ListDir 100 Capitulo 19 TLuaSFTPClientFile TLuaSFTPClientFile es una clase de solo lectura Miembros de la clase string m_sFilename string m_sLongFilename TLuaSFTPClientAttributes m_Attribs 101 Capitulo 20 TLuaSNMP Esta clase implementa un cliente SNMP basico que puede realizar operaciones set y get En este capitulo Script de ejemplo TLuaSNMP oococcconocccoccccnoncnononanano conan cn non rn cnn nana nc 104 A O O 104 A O AO 104 EEE A O A 104 aN o Ee PARAT A O A A NN 105 cl AA A A E ATA 105 VAR ee lla 106 TLUaSNMPRESUlf ici ia au 106 103 TLuaSNMP Script de ejemplo TLuaSNMP Simple example of SNMP interface SNMP TLuaSNMP SNMP Open public 1 iSyntax sData SNMP Get iso org dod internet mgmt mib 2 interfaces ifTable LERNEN y AO EEES 1 LS Vaca y if sData then prime SDAA SetExitStatus Got sample value sData bytes received true else SetExitStatus Get failed false end BeginWalk BeginWalk string sOID Parametros
19. sResult file GetDirectoryList c temp print sResult bResult fals Create a directory called temp20 on the c harddisk ii Files Crearenli wecicory Yee eEenoZ20 then print Created directory bResult true else print Failed to create directory end Delete the directory we created above if file DeleteDirectory c temp20 then bResult true print Deleted directory else print Failed to delete directory end 43 TLuaFile if bResult then SetExitStatus Test ok true else SetExitStatus Test failed false end Ejemplo 3 KNM Lua API example C 2006 Kaseya AB Script creates a new text file writes a string to it and close it Switch the context so that files are opened on the KNM host machine not translating the paths file TLuaFile true Open a text file ise Wes YWeest s ae ELUS Check if it could be created it might exist and be write protected if iRet 0 then SigceSiccing railed tOo Create tile error codes Geichasicmicmer l o No SetExitStatus sErrString false else print File created n Write a string to the file Sisi moro file Write sString string len sString Close the file EOS SN SetExitStatus Test ok true end Cerrar int Close Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario
20. string m_pData intm_iSize 123 Capitulo 25 TLuaTimer Esta clase proporciona un temporizador con precision de milisegundos En este capitulo Script de ejemplo TLuaTimer Be PANELI HERE re tet LN AEE 126 AAA A TE E A O near 126 BIS LEIA PEAS EI E en AA AA 126 125 TLuaTimer Script de ejemplo TLuaTimer Demonstrates the Lua timer interface Timer TLuaTImer miner s Streu print Timer started Wait 1000 cae MO Srila os Y Minera Scola Inicio Start Comentarios Esta funci n hace que comience a correr el tiempo y una invocaci n subsiguiente de la funci n Stop devuelve la hora entre las invocaciones de Start y Stop Despu s de que se invoca Stop invoque Start nuevamente para restablecer el temporizador e iniciar un nuevo per odo Detener int Stop Valores de devoluci n Se devuelve la cantidad de milisegundos desde la invocaci n de la funci n Start 126 Capitulo 26 TLuaWinperf Esta clase proporciona funciones para consultar valores num ricos en el registro de rendimiento de Windows Se proporciona como una alternativa f cil de usar a la clase TLuaWMIQuery m s avanzada La clase se ejecuta en el contexto de seguridad del proceso o subproceso que inicia el script En el IDE el contexto de seguridad se hereda del escritorio Cuando la ejecuta el monitor de script Lua el contexto de seguridad se puede establecer seleccionando una cuenta predeterminada en la p gina
21. RABYTE VT_SQL QUERY VI TEMPERATURE UNIT TYPE NONE UNIT TYPE FAHRENHEIT UNIT TYPE CELSIUS UNIT TYPE KELVIN VT_HUMIDITY UNIT TYPE PERCENT VT_WETNESS UNIT TYPE NONE VT_VOLTAGE UNIT TYPE VOLT VT_BANDWIDTH UTILIZATION UNIT TYPE PERCENT VT_BANDWIDTH_ USAGE UNIT TYPE KBPS UNIT TYPE MBPS UNIT TYPE GBPS WAL IDALIRISICHMOUR SJE Al 6 UNIT TYPE MEGABYTE UNIT TYPE GIGABYTE UNIT TYPE TERABYTE VT_DIRECTORY COUNT YE 2 VT_PING_PACKET UNIT TYPE PE VT_MAIL ROUN UNIT TYPE MI UNIT TYPE SECONDS UNIT TYPE NONE ING ROUNDTRIP VIN IEE 11 LLISECONDS UNIT TYPE SECONDS OSS RCENT 911181 LISECONDS Funciones globales 13 Funciones globales VT_MEMORY_USAGE UNIT TYPE MEGABYTE UNIT TYPE GIGABYT ga VT_TRANSFER SPEED UNIT TYPE NONE VT_HTTP_FETCHTIME UNIT TYPE MILLISECONDS UNIT TYPE SECONDS UE VT_WMI_GENERIC_VA UE VT_LUA_GENERIC_VA 21 VT_WINPERF GENERIC VALU 121 VT_SSH2SCRIPT GENERIC VALUI ee VT_SNMP_GENERIC_VALU UNIT TYPE NONE VT CURRENT UNIT TY
22. StoreStatisticalData bool StoreStatisticalData int iRecordSet float fData float fThreshold string Unit Valores de devoluci n Resultado verdadero si los datos se almacenaron correctamente en la base de datos estad stica resultado falso si hay un error de par metro Par metros iRecordSetindex un indice de base cero del canal estad stico en el que se almacenan los datos Consulte los comentarios para obtener constantes v lidas fData datos de punto flotante que muestrea el script fThreshold valor de umbral optativo para los datos de ejemplo Este valor debe ser constante en todas las llamadas Unit cadena optativa que describe la unidad de los datos Este valor debe ser constante en todas las llamadas La cadena puede tener 16 caracteres como m ximo De lo contrario la invocaci n falla Comentarios Esta funci n le da al script la capacidad de almacenar datos estad sticos Actualmente existen 8 canales que se pueden utilizar con este fin El par metro iRecordSetIndex puede ser una de las siguientes constantes RECORDSET_1 CORDSET CORDSET CORDSET CORDSET R T R T R T CORDSE CORDSE ECORDSE AA AN DI DI DA ee StoreStatisticalData bool StoreStatisticalData int iRecordSet float fData float fThreshold int iVirtualType int iVirtualUnit string Unit Valores de devoluci n Resultado verdadero si los dat
23. end return Enum end This function is called by KNM to retrieve a script configuration function OnConfigure Config LuaScriptConfigurator Config SetAuthor Robert Aronsson Kaseya AB Config SetDescription The script check if a certificate is about to expire within the configured number of days Config SetMinBuildVersion 5280 Config SetScriptVersion 1 0 Config AddArgument Port number Port number to connect on LuaScriptConfigurator CHECK NOT EMPTY Config AddArgument Number of days Check if certificate expres within this period LuaScriptConfigurator CHECK NOT EMPTY Config AddArgument Ignore connection problems Do you want thescript to report connection problems as well LuaScriptConfigurator ENUM AVAIL LuaScriptConfigurator CHECK NOT EMPTY Config SetEntryPoint main return Config end This is the entry point function main local iPort GetArgument 0 local iNumDays GetArgument 1 local bReportConnectionProblem false if GetArgument 2 Yes then bReportConnectionProblem true end Timeperiod that the certificate should be valid within local iOffsetTime 60 60 24 iNumDays Default values for test eval local bTestOk true local sText Certificate ok Open socket Socket TLuaSocketSec if Socket Open iPort CurrentTime TL The time was r Time Socket G ure 0 then uaDateT
24. 0 iNumber 1 do string http GetHeaderCookie count joints Cookie 7 coumt W BRENN o o Na end Extract location header string http GetHeaderLocation prime location yaW o s SEs 1009 SetExitStatus Test ok true else print Connect failed SetExitStatus Test failed false end Conectar bool Connect bool bSecure unsigned short iPort 62 TLuaHTTPClient Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iPort el n mero de puerto al cu l conectarse El puerto predeterminado es 80 bSecure si la conexi n se establecer mediante HTTPS est establecido en un valor distinto de cero sUsername nombre de usuario optativo para los servidores que requieren autenticaci n sPassword contrase a optativa para los servidores que requieren autenticaci n Comentarios La funci n establece una conexi n a un servidor HTTP con los par metros proporcionados Se debe invocar esta funci n antes de invocar cualquier otra funci n en esta clase Cerrar Close Comentarios Cierra una conexi n abierta Get int Get string sUrl string sHeaders NULL Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve
25. fico invocando la funci n global GetLastError Par metros sData una matriz con datos por enviar 115 TLuaSocket iSize el tama o de los datos en la matriz 116 Capitulo 23 TLuaSocketSecure Esta clase proporciona operaciones basicas de socket seguro lo que se suele denominar Seguridad de la capa de transporte TLS o Capa de sockets seguros SSL su predecesora En este cap tulo Script de ejemplo 1 6 nc cnn 118 O eet err 7 eer repr a arene Tm 119 COTTAM TEE ATE ET NT 119 AA TR EIER 117 N TONER 120 A O 120 9 8 8 65 1 3816 120 117 TLuaSocketSecure Script de ejemplo TLuaSocketSecure 118 This function is called by KNM when enumerating a field function OnEnumerate sFieldToEnum Enum LuaScriptEnumResult if sFieldToEnum Ignore connection problems then Enum Add Yes Enum Add No
26. n abre un archivo en el servidor FTP Despu s de que se abre el archivo se puede invocar la funci n de lectura y escritura Para cerrar el archivo se usa la funci n CloseFile Leer string Read int iSize Valores de devoluci n Se devuelve una matriz con los datos le dos en el archivo De lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iSize el tama o de los datos por leer en el archivo Cuando se devuelve la funci n contiene informaci n sobre cu nto se ley que puede ser una cantidad inferior al tama o requerido Comentarios Si no se abri un archivo se produce un error en la funci n 58 TLuaFTPClient RenameFile bool RenameFile string sOldname string sNewname Valores de devoluci n Si la funci n se ejecut correctamente el resultado es verdadero De lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sOldname el nombre antiguo del archivo al que se le cambiar el nombre sNewname el nuevo nombre del archivo Comentarios Si existe un archivo con el mismo nombre que se proporcion en el segundo par metro se produce un error en la funci n Escribir int Write string sData int iSize Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se p
27. n de conexi n fue satisfactoria de lo contrario devuelve un resultado falso Par metros sUsername nombre de usuario sPassword contrase a iPort n mero de puerto donde el servidor escucha El valor predeterminado es 22 iTimeout el tiempo de espera en milisegundos que se debe esperar que el servidor responda El valor predeterminado es 25000 25 segundos CreateFile bool CreateFile string sPath TLuaSFTPClientHandle hHandle Valor de devoluci n Devuelve un resultado verdadero si se cre el archivo si se produjo un error en la operaci n devuelve un resultado falso TLuaSFTPClientHandle contiene una referencia al archivo abierto si la operaci n es satisfactoria Par metros sPath ruta de acceso completa del archivo por crear Deben existir los directorios incluidos en la ruta de acceso De lo contrario se producir un error en la operaci n hHandle el identificador para crear el archivo Comentarios El nuevo archivo creado tiene derechos de acceso de lectura y escritura ListDir bool ListDir TLuaSFTPClientDirectoryHandle Handle Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso En una operaci n satisfactoria los datos est n listos para su recuperaci n en la clase TLuaSFTPClientDirectoryHandle 89 TLuaSFTPClient Par metros Handle identificador abierto por la funci n OpenDir MkDir bool Mk
28. string GetTime string sFormat NULL Valores de devoluci n Devuelve una cadena con la hora actual con formato seg n el par metro sFormat o en el formato predeterminado Par metros sFormat cadena optativa que contiene un formato alternativo de la hora devuelta El formato predeterminado es HH MM SS Consulte la secci n de comentarios para obtener informaci n sobre los indicadores que se pueden usar Comentarios Devuelve una cadena con la hora contenida por la instancia El formato predeterminado es HH MM DD Si proporciona su propio c digo de formato puede modificar la forma en que se devuelve la hora Indicadores de formato a nombre de d a de semana abreviado A nombre de d a de semana completo b nombre de mes abreviado B nombre de mes completo c representaci n de fecha y hora adecuada para la configuraci n regional d el d a del mes como n mero decimal de 01 a 31 H la hora en formato de 24 horas de 00 a 23 l la hora en formato de 12 horas de 01 a 12 j el d a del a o como n mero decimal de 001 a 366 56 el mes como n mero decimal de 01 a 12 M los minutos como n mero decimal de 00 a 59 p indicador actual de a m p m de la configuraci n regional para el reloj de 12 horas S los segundos como n mero decimal de 00 a 59 U la semana del a o como n mero decimal tomando el domingo como primer dia de la semana de 00 a 53
29. w el d a de la semana como numero decimal de 0 a 6 el domingo es 0 W la semana del a o como n mero decimal tomando el domingo como primer d a de la semana de 00 a 53 x representaci n de fecha para la configuraci n regional actual X representaci n de hora para la configuraci n regional actual y el a o sin el siglo como n mero decimal de 00 a 99 Y el a o con el siglo como n mero decimal 26 TLuaDateTime z Z nombre o abreviatura de la zona horaria sin caracteres si no se conoce la zona horaria Greater bool Greater TLuaDateTime DateTime Valores de devoluci n El resultado es verdadero si DateTime es menor de lo contrario es falso Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye GreaterOrEqual bool GreaterOrEqual TLuaDateTime DateTime Valores de devoluci n El resultado es verdadero si Date Time es menor o igual de lo contrario es falso Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye Less bool Less TLuaDateTime DateTime Valores de devoluci n El resultado es verdadero si DateTime es mayor de lo contrario es falso Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye LessOrEqual bool LessOrEqual TLuaDateTime DateTime Valores de devoluci n El resultado es verdadero si DateTime es may
30. 110 ndice F Final 36 FindAttribute 134 FindChildNode 134 138 FindDirectory 56 FindFile 57 Findltem 123 FindNode 138 FormatErrorString 8 FromXML 138 Funciones globales 7 G Get 25 63 104 GetArgument 8 GetArgumentCount 9 GetCertificateExpiryDate 120 GetCol 32 GetCol_AsDateTime 32 GetColType 33 GetContent 64 GetCurrentDirectory 57 GetData 134 GetDate 25 GetDeviceAddress 9 GetDirectoryList 46 GetErrorCode 79 GetErrorDescription 33 36 79 83 110 128 130 GetFileAccessedTime 46 GetFileCreatedTime 47 GetFileList 47 GetFileModifiedTime 47 57 GetFileSize 48 58 GetFileSizeMB 48 GetFileStatus 48 GetHeaderContentLength 65 GetHeaderContentTransferEncoding 65 GetHeaderContentType 65 GetHeaderCookie 65 GetHeaderCookieCount 66 GetHeaderCookies 65 GetHeaderDate 66 GetHeaderExpires 66 GetHeaderHost 66 GetHeaderLocation 64 GetHeadersRaw 64 GetLastError 9 GetParentNode 134 GetProperty 130 GetResult 128 GetRootNode 138 GetStdErr 79 110 GetStdOut 79 110 GetTag 134 GetTime 26 Greater 27 GreaterOrEqual 27 Igual a 24 141 indice Inicio 126 IsIDE 9 IsValid 135 L Leer 49 58 91 115 120 Less 27 LessOrEqual 27 ListDir 89 LuaScriptConfigurator 17 LuaScriptEnumResult 15 maq 96 MessageBox 10 MkDir 90 Modelo de programaci n 3 ModifiedTime 9
31. 48 TLuaFile MoveFile int MoveFile string sSource string sDest Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sSource la ruta de acceso y el nombre del archivo por mover sDest la nueva ruta de acceso y el nuevo nombre del archivo Comentarios La funci n mueve un archivo Debe existir el directorio al que se mover el archivo De lo contrario se produce un error en la funci n No se pueden mover directorios con esta funci n Abra int Open string sFileName bool bCreate false Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFileName el nombre y la ruta de acceso del archivo por abrir o crear bCreate si est establecido en un valor distinto de cero la funci n crea un nuevo archivo Si ya existe el archivo especificado su contenido se destruye Comentarios Si bCreate est establecido en cero y el archivo no existe se produce un error en la funci n Leer string int Read int iSize Valores de devoluci n Si la funci n se ejecut correctamente e Size est establecido en el tama o de los datos devueltos se devuel
32. Piti aa a ciate ste eee aan 24 191 11 2 nn teed ta pect 24 TSV RER A RI A e AA taal 25 CODA cra ol ta ce 25 Getum 1 a errr Arten 26 6 102121 18 e a enue at aS 27 Greater OIE 2 AEE 27 B hs ra ee a 27 EOSSOrEQUakt za a dee ee eon e eae ce 27 No SIU ea 27 Establece a dada bie Abas 28 TLuaDateTime Agregar Add TLuaDateTime DateTime Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye Comentarios Esta funci n agrega al activo la hora contenida en el par metro DateTime Crear Create int Year int Month int Day int iHour int Minute int iSecond Par metros Year a o por ejemplo 1972 iMonth n mero de mes por ejemplo 10 iDay n mero de d a del mes por ejemplo 2 iHour hora para utilizar puede ser cero iMinute minutos para utilizar puede ser cero iSecond segundos para utilizar puede ser cero Comentarios Esta funci n crea un valor TLuaDateTime que contiene un tiempo absoluto CreateSpan CreateSpan int Hour int iMinute int
33. con el nombre del contador por consultar sinstanceName optativo una cadena con el nombre de la instancia de contador Comentarios Los nombres de activo de contador y de instancia se pueden obtener en el monitor Winperf de Network Monitor para ello se debe hacer clic en el bot n de enumeraci n o utilizar la aplicaci n perfmon exe de Windows Para recuperar el valor invoque GetResult despu s de que se completa esta funci n 128 Capitulo 27 TLuaWMIQuery Esta clase proporciona funciones para consultar las propiedades de WMI La clase se ejecuta en el contexto de seguridad del proceso o subproceso que inicia el script En el IDE el contexto de seguridad se hereda del escritorio Cuando la ejecuta el monitor de script Lua el contexto de seguridad se puede establecer seleccionando una cuenta predeterminada en la p gina de propiedades del monitor La cuenta debe tener habilitada la delegaci n En este cap tulo Teua WMI QUEI ia A 130 A A 130 GetErrorDescriptiO sissies eat cet lts dada 130 5121191916 i tea ANE 130 NextinstaCO ocur 131 SelNamespaceriiiiaid ta de hase 131 129 TLuaWMIQuery TLuaWMIQuery Demonstrates the Lua WMI interface Query TLuaWMIQuery Query Execute selec
34. de propiedades del monitor En este cap tulo Script de ejemplo 1 1 cnc ran rn 128 Ge tErrorDeSCriptions i secs atte ia Dad 126 GEIRESUlE Er Mea Er ER creer eee 128 ON here ecper eer e FREE NTE 128 127 TLuaWinperf Script de ejemplo TLuaWinperf Prints the number of private bytes the notepad exe application have allocated Perf TLuaWinperf if Perf Query Process Private Bytes notepad then Value Perf GetResult print Value else print Perf GetErrorDescription end GetErrorDescription string GetErrorDescription Valores de devoluci n Devuelve una cadena que describe el ltimo error detectado cuando se invoca cualquier funci n de la clase GetResult double GetResult Valores de devoluci n Devuelve un valor de contador num rico Si se produce un error en la invocaci n previa de Query esta funci n devuelve cero Query bool Query string sDeviceName string sSCounterName string sinstanceName NULL Valores de devoluci n El resultado es verdadero si la consulta se ejecut correctamente si ocurri un error el resultado es falso Par metros sDeviceName una cadena con el nombre del activo que contiene el contador por consultar sCounterName una cadena
35. de error especifico invocando la funci n global GetLastError Par metros iSize Cuando se devuelve la funci n se establece en el tama o de la cadena devuelta Comentarios El contenido hace referencia a los datos que devuelve una solicitud que sigue al encabezado GetHeadersRaw string GetHeadersRaw Valores de devoluci n Si se ejecuta correctamente devuelve una cadena que contiene los encabezados devueltos por la solicitud De lo contrario se devuelve una cadena vac a Comentarios Los encabezados se devuelven exactamente como los env a el servidor GetHeaderLocation string GetHeaderLocation Valores de devoluci n Si se ejecut correctamente devuelve una cadena con el encabezado Location De lo contrario se devuelve una cadena vac a 64 TLuaHTTPClient GetHeaderContentLength int GetHeaderContentLength Valores de devoluci n La longitud en bytes de la porci n de contenido de la solicitud GetHeaderContentType string GetHeaderContentType Valor de devoluci n Si se ejecut correctamente devuelve una cadena con el encabezado Content Type De lo contrario se devuelve una cadena vacia GetHeaderContentTransferEncoding string GetHeaderContentTransferEncoding Valor de devoluci n Si se ejecut correctamente devuelve una cadena con el encabezado Transfer Encoding De lo contrario se devuelve una cadena vacia GetHeaderCookies string GetHeaderCookies Valor
36. devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Comentarios Cierra el archivo y lo pone como no disponible para lectura y escritura Si no cerr el archivo antes de que se destruya el activo el destructor lo har por usted CopyFile int CopyFile string sSource string sDest Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError 44 TLuaFile Par metros sSource ruta de acceso y nombre del archivo por copiar sDest nueva ruta de acceso y nombre del archivo nuevo Comentarios La funci n copia un archivo No se pueden copiar directorios con esta funci n CreateDirectory int CreateDirectory string sPath Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sPath ruta de acceso del directorio por crear Comentarios Debe existir el directorio primario del directorio por crear De lo contrario se produce un error en la funci n DeleteDirectory int DeleteDirectory string sDirectory Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo co
37. directorio se devuelve con su ruta de acceso completa Los directorios de la cadena est n separados por un car cter de retorno de carro 56 TLuaFTPClient FindFile string FindFile string sWildcard Valores de devoluci n Devuelve una cadena con los archivos enumerados separados por un car cter de retorno de carro De lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sWildCard el comod n para filtrar los archivos deseados Para recuperar todos los archivos del directorio use el comod n Comentarios La cadena de devoluci n contiene todos los archivos del directorio actual que coinciden con el comod n proporcionado Cada archivo se devuelve con su ruta de acceso completa Los archivos de la cadena est n separados por un car cter de retorno de carro GetCurrentDirectory int GetCurrentDirectory string sDir Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sDir la ruta de acceso del nuevo directorio actual Comentarios Si no existe el directorio se produce un error en la funci n GetFileModifiedTime TLuaDate Time GetFileModifiedTime string sFilename Valores de devoluci n Si la funci n se ejecut correctamente se devue
38. funci n de punto de entrada Network Monitor invoca esta funci n para iniciar la ejecuci n del script De manera predeterminada el nombre del punto de entrada es main pero el programador puede establecer cualquier nombre excepto los nombres de funci n reservados Modelo de programaci n Ejemplo This function is called by KNM when enumerating a field function OnEnumerate sFieldToEnum The variable returned must be called Config so KNM can find it Enum LuaScriptEnumResult Second argument if sFieldToEnum Argument 2 then Enum Add First value Enum Add Second value Enum Add Third value end return Enum end This function is called by KNM to retrieve a script configuration function OnConfigure The variable returned must be called Config so KNM can find it Config LuaScriptConfigurator 11111 Config SetAuthor My name Description Config SetDescription Description of the script including usage parameters etc Minimum build version of KNM set to zero for if no specificbuild version is required Config SetMinBuildVersion 0 Script version major minor Config SetScriptVersion 1 0 A parameter configuration add them in the order the script isextracting them Config AddArgument Argument 1 This is the description of thefirst argument LuaScriptConfigurator CHECK NOT EMPTY Add another parameter a select box wi
39. iSecond Par metros iHour hora para utilizar puede ser cero iMinute minutos para utilizar puede ser cero iSecond segundos para utilizar puede ser cero Comentarios Esta funci n crea un valor TLuaDateTime que no contiene un tiempo absoluto sino un lapso de tiempo que se puede utilizar para sumar a otro activo de TLuaDateTime o restar de este Igual a bool Equal TLuaDateTime DateTime Valores de devoluci n El resultado es verdadero si DateTime es igual de lo contrario es falso 24 TLuaDateTime Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye Get int Get Valores de devoluci n Cantidad de segundos que contiene la instancia Comentarios Esta funci n se puede usar para recuperar la cantidad de segundos que contiene la instancia en forma de tiempo absoluto GetDate string GetDate string sFormat NULL Valores de devoluci n Devuelve una cadena con la hora actual con formato seg n el par metro sFormat o en el formato predeterminado Par metros sFormat cadena optativa que contiene un formato alternativo de la hora devuelta El formato predeterminado es AA MM DD Consulte la secci n de comentarios para obtener informaci n sobre los indicadores que se pueden usar Comentarios Devuelve una cadena con la hora contenida por la instancia El formato predeterminado es AA MM DD Si proporciona su propio c digo de formato pue
40. red En este capitulo Script de ejemplo TLualCMP conc cnn rca nan en 68 BEGIN ACC ETE A 9 egs 68 A 7 5 RE 69 Next 17219 181 181 a ete 69 TLualCMP Script de ejemplo TLualCMP Description Trace rout xampl icmp TLualCMP iPacketSize 32 packet size in bytes excluding the header bNoFragment false Set to true to inhibit fragmentation of packet sent iMaxHops 255 Max number of hops in route Begin trace bok icmp BeginTrace iPacketSize bNoFragment iMaxHops if bok true then SetExitStatus Trace failed false end Print the result ico L Result TLuaICMPTraceResult while icmp NextTraceResult Result do osa 601131 85099 110115 print Result m Name print Result m iRoundTripTimeMs iCount 1CSume F 1 end Clean up resources icmp EndTrace Serbzilcsceacus Trace Ok wwe BeginTrace bool BeginTrace int iPacketsToSend int iPacketSize bool bNoFragment int iTimeoutMs Valores de devoluci n Esta funci n devuelve un resultado verdadero si el seguimiento fue satisfactorio y un resultado falso si se produjo un error Par metros iPacketsToS
41. versi n de Network Monitor que el script requiere como m nimo Comentarios El n mero de versi n m nima es un campo muy importante para establecer Este comunica a Network Monitor si el script se puede utilizar con la versi n actual de Network Monitor De manera predeterminada este n mero se debe establecer en el n mero de la versi n que utiliz el autor para probar el script SetScriptVersion SetScriptVersion int iMajor int iMinor Par metros iMajor el n mero de versi n principal del script 20 LuaScriptConfigurator iMinor el n mero de versi n secundaria del script Comentarios El autor del script debe establecer un n mero de versi n del script Una versi n principal de 0 indica que el script est en una etapa beta y que otros usuarios s lo lo deben utilizar para continuar desarroll ndolo Cada vez que se modifica el script se debe aumentar el n mero de la versi n Un cambio en el n mero de versi n principal debe reflejar una rescritura o una mejora de gran escala El n mero de versi n secundaria indica una mejora de menor escala 21 Capitulo 5 TLuaDateTime TLuaDateTime proporciona funciones de fecha y hora Time es la hora local representada en segundos desde el 1 de enero de 1970 En este capitulo AM acces AA ee 24 GRC a A A ESTER 24 CreateS
42. 0 EXECUTE COMMANG NN 110 61 11 19 110 0 11191116 1 8 add 110 ETEESI a RECENT RE cad ets id tre 110 Gota Uta 7 110 E tr rrireere eter trrree trere PTR 111 109 TLuaSSH2Client Script de ejemplo TLuaSSH2Client SSHClient TLuaSSH2Client SSHClient Open 23 testuser testpassword if SSHClient ExecuteCommand shutdown true then print SSHClient GetStdOut Seuirales ictus Misses Ol true p else print SSHClient GetStdErr print SSHClient GetErrorDescription Sence cios Mase renle true end ExecuteCommand bool ExecuteCommand string sCommand DWORD dwWait 2500 Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sCommand la cadena con el comando por ejecutar en el host remoto dwWait optativo el tiempo que hay que esperar para que finalice la ejecuci n El valor predeterminado es 25 segundos GetErrorDescription string GetErrorDescription void Valores de devoluci n Devuelve la descripci n del error m s reciente generada po
43. 6 MoveFile 49 N NextInstance 131 NextRow 33 NextTraceResult 69 No igual a 27 O Open_ForAppend 91 Open_ForRead 90 Open_ForWrite 91 OpenDir 90 OpenFile 58 OpenTCP 114 OpenUDP 115 P PermissionBits 97 Ping 69 Post 63 print 10 Propietario 96 Q Query 37 128 R ReadData 50 ReadValue 84 85 Remover 92 RenameFile 50 59 Renombrar 92 Resultado 6 ResultAvilable 34 RmDir 92 S Script avanzado 4 Script de ejemplo 142 OnConfigure 18 OnEnumerate 16 TLuaDB 30 TLuaDNS 36 TLuaFTPClient 54 TLuaHTTPClient 62 TLualCMP 68 TLuaPowershell 77 TLuaPowershell Windows Scripting 78 TLuaRegistry 82 TLuaSFTPClient 88 TLuaSNMP 104 TLuaSocket 114 TLuaSocketSecure 118 TLuaSSH2Client 110 TLuaTimer 126 TLuaWinperf 126 Script simple 6 Scripts de muestra TLuaFile 43 SeekFromCurrent 50 SeekFromEnd 51 SeekFromStart 51 SetAuthor 20 SetCharacterLimits 19 SetDescription 20 SetEntryPoint 19 SetExitStatus 10 SetLastError 10 SetMinBuildVersion 20 SetNamespace 131 SetNumericLimits 19 SetScriptVersion 20 SetValue 85 86 SetValueExpandedString 86 Siguiente 37 100 SizeMB 97 StoreStatisticalData 11 Sub 28 Tama o 97 TLuaDateTime 23 TLuaDB 29 TLuaDNS 35 TLuaDNS_ARecord 38 TLuaDNS_CNAMERecord 38 TLuaDNS_MXRecord 38 TLuaDNS_NSRecord 38 TLuaDNS_PTRRecord 38
44. 89 131 SEINAMCS PACE is sete anand 131 TLuaXMLNode 133 FIndAttribUte it ceed tie edict A aa RE IRRE dd eases Minder geste eed date 134 FindGhildNode ica poe 134 G tData aN 134 GETAG GA eee Biene 134 6 006 2m RER Mode a PA eee 134 EE IHREN 135 TLuaXMLReader 137 EndGhldN ode oa 138 ENANO de earner 138 EMAIL ette econ oline TEN 138 GElRODINOde Stats ora ios 138 vi indice 141 API de Lua para Network Monitor API de Lua para Network Monitor En esta documentaci n se abarca la API de Lua para Network Monitor Network Monitor usa Lua 5 0 Lua Lua es un lenguaje de programaci n eficaz y liviano dise ado para extender aplicaciones Adem s se utiliza con frecuencia como lenguaje independiente de uso general Lua es software gratuito que combina una sintaxis de procedimiento simple con construcciones eficaces de descripci n de datos basadas en matrices asociativas y en una sem ntica extensible Lua se escribe en forma din mica se interpreta a partir de c digos de byte y tiene administraci n d
45. Dir string sPath Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros sPath la ruta de acceso al directorio por crear incluye el nombre del directorio nuevo Comentarios Esta funci n no puede crear nuevos directorios de manera recursiva Deben existir todos los directorios primarios del ltimo directorio en la ruta de acceso OpenDir bool OpenDir string sPath TLuaSFTPClientDirectoryHandle amp Handle Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros sPath la ruta de acceso al directorio que se desea abrir Handle identificador que se devuelve para usar en operaciones subsiguientes Comentarios Esta funci n abre un directorio para enumerar su contenido con la funci n ListDir Open_ForRead bool Open_ForRead string _sPath TLuaSFTPClientHandle hHandle Valor de devoluci n Devuelve un resultado verdadero si el archivo se abri correctamente si se produjo un error en la operaci n devuelve un resultado falso Par metros sPath ruta de acceso completa del archivo hHandle identificador del archivo que se usa en operaciones subsiguientes 90 TLuaSFTPClient Open_ForWrite bool Open_ForWrite string _sPath TLuaSFTPClientHandle hHandle Valor de devoluci n Devuelve un resultado verdadero si el archivo se a
46. Kaseya 2 Network Monitor API Guia del usuario Espanol Agreement The purchase and use of all Software and Services is subject to the Agreement as defined in Kaseya s Click Accept EULATOS as updated from time to time by Kaseya at http www kaseya com legal aspx If Customer does not agree with the Agreement please do not install use or purchase any Software and Services from Kaseya as continued use of the Software or Services indicates Customer s acceptance of the Agreement 2014 Kaseya All rights reserved www kaseya com Contenido API de Lua para Network Monitor 1 Modelo de programacion 3 SCHPUAVANZAOG Hie A a Ace ey A 4 Script simple slay na a ane ed 6 CONTEXTO DO ACTIVOS 7 et avid ay cde dee aa dead 6 Restado arieni ee a ey ea 6 Funciones globales 7 0 614 1 1012766101118 1 2 56 RE Ane Ae lh ea heehee 8 FormatErrorstring acseaih Aces AA A A A AA 8 GetArgument 2 AA ee ee ea ee 8 GetArgumentGountininias nial kin 9 Getk stErfor r 2 2 ee en Be ee ee es 9 GetDeviceAddr amp ss u 22H MR 9 IDE neun ARE I AU IA 9 MessageBoXa u nn 10 919141 DEE
47. LO E L A E soe kate cl e nen mE 92 111101 A EN 92 ESC o ll e dental 93 TLuaSFTPClientAttributes 95 ACCESS NO taste siete acct o eA cee oT 96 GOALS A TAM Se ii 96 Mi BON A eee er 96 Modified Time E ih ss satte iia 96 Propietario ine ee 11 tre 96 PermissionBilsiirsssress A ce 97 IAIN tocan 97 SIZE MB occa toes iia tia E 97 TLuaSFTPClientDirectoryHandle 99 SIQUICMLG 27 tegen ee pes Satine at a a earner 100 TLuaSFTPClientFile 101 TLuaSNMP 103 Script de ejemplo TLUASNMP ceeeeeeeaeeeeaeeenaeee cage eeeaaesaaeesaeeesaaesseaaesseeeeseaeeseaeeseaeeeeaes 104 Begi alk 9 tt a He Ehe 104 A aaah 3 th teats Sea e 104 GS ii Renee
48. LuaFTPClient Par metros sDir la ruta de acceso del directorio por crear Comentarios Debe existir el directorio donde se crear el nuevo directorio De lo contrario se produce un error en la funci n DeleteDirectory int DeleteDirectory string sDir Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sDir la ruta de acceso del directorio por eliminar Comentarios Si el directorio no est vac o se produce un error en la funci n DeleteFile int DeleteFile string sFilename Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFilename la ruta de acceso y el nombre del archivo por eliminar Comentarios Si no existe el archivo se produce un error en la funci n FindDirectory string FindDirectory Valores de devoluci n Devuelve una cadena con los directorios enumerados separados por un car cter de retorno de carro de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Comentarios La cadena de retorno contiene todos los subdirectorios del directorio actual Cada
49. PE AMPERE VIT FANS PEED UNTAR VI LUMINOSITY UNIT TYPE LUX El par metro RecordSetIndex puede ser una de las siguientes constantes RECORDSET_1 ECORDSET_2 ECORDSET_3 ECORDSET_4 ECORDSET_5 ECORDSET_6 ECORDSET_7 ECORDSET_8 AAN N DI DI A DDP D a DDP D VAN N DI DI A Wait Wait int iMs Par metros iMs la cantidad de milisegundos que debe esperar la ejecuci n del script Comentarios Esta funci n invoca que la funci n de suspensi n del SO suspenda la ejecuci n del subproceso que ejecuta al script 14 Capitulo 3 LuaScriptEnumResult Esta clase proporciona una interfaz para introducir resultados de enumeraci n en la funci n de devoluci n de llamada de OnEnumeration En este capitulo Script de ejemplo ONENUMerate tettet nan en 16 AGO GI aai EIER 77 ISA 16 LuaScriptEnumResult Script de ejemplo OnEnumerate function OnEnumerate sFieldToEnum The variable returned must be called Config so KNM can find it Enum LuaScriptEnumResult Second argument if sFieldToEnum Argument 2 then Enum Add First value Enum Add Second value Enum Add Third value
50. TLuaDNS_SOARecord 38 TLuaDNS_TXTRecord 39 TLuaFile 41 TLuaFTPClient 53 TLuaHTTPClient 61 TLualCMP 67 TLualCMPPingResult 71 TLualCMPTraceResult 73 TLuaPowershell 75 TLuaRegistry 81 TLuaSFTPClient 87 TLuaSFTPClientAttributes 95 TLuaSFTPClientDirectoryHandle 99 TLuaSFTPClientFile 101 TLuaSNMP 103 TLuaSNMPResult 106 TLuaSocket 113 TLuaSocketSecure 117 TLuaSSH2Client 109 TLuaStorage 121 TLuaStorageltem 123 TLuaTimer 125 TLuaWinperf 127 TLuaWMlQuery 129 130 TLuaXMLNode 133 TLuaXMLReader 137 Updateltem 122 W Wait 14 Walk 106 Indice 143
51. a el tiempo almacenado en el activo o lo compara con otro activo TLuaDateTime GetFileList string GetFileList string sDirectory string sWildCard Valores de devoluci n Devuelve una cadena con los archivos enumerados separados por un car cter de retorno de carro De lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sDirectory ruta de acceso del directorio sWildCard el comod n para filtrar los archivos deseados Para recuperar todos los archivos del directorio use el comod n Comentarios La cadena de devoluci n contiene todos los archivos del directorio que coinciden con el comod n proporcionado Cada archivo se devuelve con su ruta de acceso completa Los archivos de la cadena est n separados por un car cter de retorno de carro GetFileModifiedTime TLuaDate Time GetFileModifiedTime string sFilename Valores de devoluci n Devuelve un activo TLuaDateTime que contiene la hora en que se modific el archivo por ltima vez De lo contrario devuelve un activo TLuaDateTime que contiene el valor O Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFilename la ruta de acceso y el nombre del archivo Comentarios Usa el activo TLuaDateTime para construir una cadena que representa el tiempo almacenado en el activo o lo compara con otro activo TLuaDateTime 47 TLu
52. a la direcci n IP de forma rigida en el activo actual Resultado Cuando se produce la salida de un script este necesita comunicarle a Network Monitor si la prueba fue correcta o no Se suministra una funci n global para este prop sito SetExitStatus SetExitStatus es una funci n obligatoria que se debe invocar antes de que termine el script Capitulo 2 Funciones globales Las funciones globales son funciones que no estan relacionadas con un activo Existe una cantidad de funciones globales en la API de Lua para Network Monitor Algunas deben invocar cuando se produce la salida de un script En este capitulo ConvertFromUTF16 en 8 FormatErrorStriNg 8 GOA UM Nunca A IEE dante die 8 GTA GUMERL COUN wisiies ia hah ica net E ETEEN EE NEEE OENAR ehren heran 9 20 11 3 11 11011 9 CODINA 9 ISDES oe alco cess rt e 9 Mos sdo BOK en ii da 10 Plis 10 SEIEXIT STATUS ne 10 SS TASTE ION 2 10 StOreStatistical Data 11 StOrEStatistut
53. aFile GetFileSize int GetFileSize string sFile Valores de devoluci n Se devuelve el tama o del archivo en cantidad de bytes si la funci n se ejecuta correctamente Si no se puede acceder al archivo el valor de devoluci n es 1 Par metros sFile la ruta de acceso y el nombre del archivo Comentarios La funci n se limita a archivos con menos de 2731 bytes GetFileSizeMB int GetFileSizeMB string sFile Valores de devoluci n Se devuelve el tama o del archivo en cantidad de megabytes si la funci n se ejecuta correctamente Si no se puede acceder al archivo el valor de devoluci n es 1 Par metros sFile la ruta de acceso y el nombre del archivo GetFileStatus int GetFileStatus string sFile Valores de devoluci n Se devuelve un valor que describe el estado actual del archivo si la funci n se ejecuta correctamente Si no se puede acceder al archivo el valor de devoluci n es 1 Par metros sFile la ruta de acceso y el nombre del archivo Comentarios La funci n devuelve una combinaci n de los siguientes indicadores para describir el estado del archivo FILE_NORMAL 0x00 Archivo normal FILE_READONLY 0x01 El archivo es de s lo lectura FILE_HIDDEN 0x02 El archivo est oculto FILE_SYSTEM 0x04 El archivo es un archivo de sistema FILE_VOLUME 0x08 El archivo es un volumen FILE_DIR 0x10 El archivo es un directorio FILE_ARCHIV 0x20 El archivo tiene establecido el bit de archivo
54. ace bd GreateDirettony un ea a an A D6leteDINOGIONY ieii ante Deletekild c id nee ee A AAA DOEBSEIEEXISE A nn E nee Maia dice east Nennen deines GetDirectory List sates GEtFIIGACCESSCO TIM nee OM laude di Ne lanciert GelFile Create TIME u a a nissen ern GOST RIS LAS te Es Seales Be nn ee ner ee nern Coe Modi d M A a ii a asia cid A EE E E T E EAE EAE AE A E OO E ESPAA m EE E AA a A E A EA E GEetEileStalus raten A E o ld rn en E REINAN E EA a A E A A AAE R eo lato ado as SECKFLOMGUITENI AES E E A A E ptes ld AA EE A E 1 11 ARETA 10T PEE e AEA E E o E A AE AE Seek Mad a a e o ESC A A A ee ee TLuaFTPClient Create DIRS CLONY cia Aia DelstoDirectoV tir A i Rac wea adic FINODIFSC O Yi RI ER Lone 7111612111 2222 irn GetCurrentDirectony vico vai i a ce a dia a GetEileModifiedTiMe n r ene Anas dled Adee TLuaHTTPClient Script de ejemplo 11 81 5 8
55. be reposicionar el puntero a archivo Comentarios La funci n mueve la posici n actual del puntero a archivo el valor especificado en iNumberofBytes desde el final del archivo Tenga en cuenta que iNumberofBytes debe ser negativo para poder mover el puntero a archivo hacia arriba en el archivo SeekFromStart int SeekFromStart int iNumberofBytes Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros NumberofBytes la cantidad de bytes contada desde el comienzo del archivo en la que se debe reposicionar el puntero a archivo Comentarios La funci n mueve la posici n actual del puntero a archivo el valor especificado en iNumberofBytes desde el comienzo del archivo El puntero se puede posicionar despu s del final del archivo esto borra el marcador del final del archivo Escribir int Write string sData int iSize Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sData la matriz de datos por escribir en el archivo iSize el tama o de los datos por escribir Comentarios La funci n escribe desde la posici n actual del puntero a archi
56. bri correctamente si se produjo un error en la operaci n devuelve un resultado falso Par metros sPath ruta de acceso completa del archivo hHandle identificador del archivo que se usa en operaciones subsiguientes Open_ForAppend bool Open_ForAppend string _sPath TLuaSFTPClientHandle hHandle Valor de devoluci n Devuelve un resultado verdadero si el archivo se abri correctamente si se produjo un error en la operaci n devuelve un resultado falso Par metros sPath ruta de acceso completa del archivo hHandle identificador del archivo que se usa en operaciones subsiguientes Comentarios Open_ForAppend abre el archivo en modo de escritura La diferencia entre esta funci n y Open_ForWrite es que todos los datos se escriben al final del archivo incluso si el puntero a archivo se reposiciona entre dos escrituras Leer bool Read TLuaSFTPClientHandle FileHandle int Offset int iLen string amp sData Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros FileHandle identificador del archivo abierto anteriormente iOffset desplazamiento en bytes desde donde leer el archivo iLen longitud de datos por leer sData variable donde se colocan datos Comentarios S lo se pueden leer archivos de texto con esta funci n 91 TLuaSFTPClient Ejemplo KNM Lua API example C 2010 Kaseya AB Demonstrat
57. ca can actin ee esha adage eddie dee eddie 78 EXO CULE COMMANG 79 A SONAS 79 75 TLuaPowershell GetStdErr GetErrorDescription a aa GetErrorCode 76 TLuaPowershell Script de ejemplo TLuaPowershell executes a Powershell command string bExitStatus false PS TLuaPowershell bStatus PS Open 5985 false if bStatus true then sCmd Get Date n bExec PS ExecuteCommand sCmd if bExec true then sStatus PS GetStdOut bExitStatus true else 5702111116 EAS Ue le IS GS Salte end else sStatus Failed to open connection PS GetErrorDescription end SetExitStatus sStatus bExitStatus 77 TLuaPowershell Script de ejemplo TLuaPowershell Windows Scripting Create a script file named test vbs in your C temp folder on the remote asset for this sample to work The file should look like this strFile WScript Arguments 0 Set objFSO CreateObject Scripting FileSystemObject Set objFile obj FSO GetFile strFile strFileSize objFile Size ocroti Mela siewinalke E als a The script takes one parameter That is the path to a file used for checking the file size bExitStatus false PS TLuaPowershell bStatus PS Open 5985 false if bStatus true t
58. calD ala aaa dida 11 21 2 ea S 14 Funciones globales ConvertFromUTF16 string ConvertFromUTF16 local UTF1 6data int iSize Valores de devoluci n Una cadena de 8 bits convertida a partir de la cadena UTF16 Par metros UTF16data cadena UTF16 doble byte le da por TLuaFile ReadData iSize tama o de la cadena Comentarios La funci n s lo acepta datos creados por la funci n TLuaFile ReadData FormatErrorString string FormatErrorString int iError Valores de devoluci n Una cadena que describe el c digo de error iError Par metros iError un c digo de error de Windows que se obtuvo anteriormente al invocar la funci n GetLastError Comentarios Esta funci n puede utilizarse para proporcionarle al usuario texto significativo en lugar de un c digo de error GetArgument string GetArgument int iNumber Valores de devoluci n Un argumento transmitido por la aplicaci n de llamada Par metros iNumber un indice de base cero del argumento que se debe recuperar La cantidad m xima de argumentos se puede determinar invocando GetArgumentCount Comentarios Una aplicaci n de llamada puede transmitir una cantidad de argumentos al script Lua para personalizar su comportamiento Con esta funci n y la GetArgumentCount relacionada el programador puede extraer los argumentos Funciones globales GetArgumentCount int GetArgumentCount Valores de devoluci n La cantidad de argu
59. cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sUrl URL relativa a la URL base del sitio sHeaders cadena de encabezado optativa que contiene los encabezados que se deben enviar con la solicitud Comentarios La conexi n siempre est abierta en el contexto del activo Por lo tanto la URL proporcionada a la funci n siempre debe ser relativa a la URL base Post int Post string sUrl string sHeaders NULL string sData NULL Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError 63 TLuaHTTPClient Par metros sUrl URL relativa a la URL base del sitio sHeaders cadena de encabezado optativa que contiene los encabezados que se deben enviar con la solicitud sData datos optativos para incluir en la solicitud post Comentarios La conexi n siempre est abierta en el contexto del activo Por lo tanto la URL proporcionada a la funci n siempre debe ser relativa a la URL base Todos los encabezados proporcionados deben terminar con un par CR LF GetContent string GetContent int iSize Valor de devoluci n Si se ejecuta correctamente devuelve una cadena con la porci n de contenido de una solicitud GET de lo contrario no devuelve nada Se puede recuperar un c digo
60. cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por escribir sData los datos que se escribir n en el valor iSize tama o de los datos por escribir en bytes Comentarios La funci n escribe los datos especificados en el valor 85 TLuaRegistry SetValue bool SetValue string sValueName string sString Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por escribir sString la cadena que se escribir en el valor iSize tama o de los datos por escribir en bytes Comentarios La funci n escribe la cadena especificada en el valor Si el valor no existe se produce un error en la funci n SetValue bool SetValue string sValueName int iValue Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por escribir iValue el entero que se escribir en el valor Comentarios La funci n escribe el entero especificado en el valor Si el valor no existe se produce un error en la func
61. cuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sOrgFile la ruta de acceso y el nombre del archivo al que se le desea cambiar el nombre sNewFile la nueva ruta de acceso y el nuevo nombre del archivo Comentarios La funci n cambia el nombre de un archivo No se pueden cambiar nombres de directorios con esta funci n SeekFromCurrent int SeekFromCurrent int iNumberofBytes Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iNumberofBytes la cantidad de bytes relativa a la posici n actual en la que se debe reposicionar el puntero a archivo Comentarios La funci n mueve el puntero a archivo en relaci n con la posici n actual Se pueden especificar tanto valores negativos como positivos El puntero se puede posicionar despu s del final del archivo esto borra el marcador del final del archivo 50 TLuaFile SeekFromEnd int SeekFromEnd int iNumberofBytes Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iNumberofBytes la cantidad de bytes contada desde el final del archivo en la que se de
62. de clave del elemento Ya debe existir una clave con nombre sData los datos optativos que se relacionan con el elemento Los datos reemplazan los datos actuales almacenados en el elemento si los hubiera iSize el tama o de los datos S lo se necesita si los datos se proporcionan con la funci n Comentarios La funci n actualiza un elemento que ya est creado Si la combinaci n de elemento y clave no existe se produce un error en la funci n Deleteltem void Deleteltem string sName string sKey Par metros sName el nombre del elemento sKey el nombre de la clave por eliminar Comentarios La funci n elimina una combinaci n de elemento y clave Los datos relacionados con la clave tambi n se eliminan 122 TLuaStorage Findltem TLuaStorageltem Findltem string sName string sKey Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros sName el nombre nico del elemento Ya debe existir un elemento con este nombre sName el nombre de clave del elemento Ya debe existir una clave con nombre Comentarios La funci n recupera un elemento almacenado La clase devuelta contiene los nombres de elemento y clave as como los datos relacionados con el elemento TLuaStorageltem TLuaStorageltem es una clase de s lo lectura Si se modifica se inicia una excepci n Miembros de la clase string m_Key string m_Name
63. de devoluci n Si se ejecuta correctamente devuelve una cadena que contiene todas las cookies devueltas por el servidor separadas por un car cter de retorno de carro De lo contrario devuelve una cadena vacia GetHeaderCookie string GetHeaderCookie int ilndex Valor de devoluci n Se devuelve una cadena con la cadena de cookies solicitada Par metros ilndex un ndice de base cero que especifica la cookie por devolver Comentarios Si se especifica un n mero negativo o un ndice fuera de intervalo se devuelve una cadena vac a 65 TLuaHTTPClient GetHeaderCookieCount int GetHeaderCookieCount Valor de devoluci n Se devuelve la cantidad de cookies devueltas por la solicitud GetHeaderDate string GetHeaderDate Valor de devoluci n Si se ejecut correctamente se devuelve una cadena con el encabezado Date De lo contrario se devuelve una cadena vacia GetHeaderExpires string GetHeaderExpires Valor de devoluci n Si se ejecut correctamente se devuelve una cadena con el encabezado Expires De lo contrario se devuelve una cadena vacia GetHeaderHost string GetHeaderHost Valor de devoluci n Si se ejecut correctamente se devuelve una cadena con el encabezado Host De lo contrario se devuelve una cadena vacia 66 Capitulo 11 TLualCMP Esta clase proporciona funciones de ping y de seguimiento de ruta que se pueden utilizar para diagnosticar una conexi n de
64. de modificar la forma en que se devuelve la hora Indicadores de formato a nombre de d a de semana abreviado A nombre de d a de semana completo nombre de mes abreviado B nombre de mes completo c representaci n de fecha y hora adecuada para la configuraci n regional d el d a del mes como n mero decimal de 01 a 31 H la hora en formato de 24 horas de 00 a 23 l la hora en formato de 12 horas de 01 a 12 j el d a del a o como n mero decimal de 001 a 366 56 el mes como n mero decimal de 01 a 12 M los minutos como n mero decimal de 00 a 59 55 indicador actual de a m p m de la configuraci n regional para el reloj de 12 horas S los segundos como n mero decimal de 00 a 59 U la semana del a o como n mero decimal tomando el domingo como primer dia de la semana de 00 a 53 w el d a de la semana como n mero decimal de 0 a 6 el domingo es 0 25 TLuaDateTime W la semana del a o como n mero decimal tomando el domingo como primer dia de la semana de 00 a 53 x representaci n de fecha para la configuraci n regional actual X representaci n de hora para la configuraci n regional actual y el a o sin el siglo como numero decimal de 00 a 99 Y el a o con el siglo como n mero decimal z Z nombre o abreviatura de la zona horaria sin caracteres si no se conoce la zona horaria GetTime
65. e ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre de un valor por eliminar Comentarios Esta funci n elimina un valor en la clave actual Si el valor no existe se produce un error en la funci n EnumValue bool EnumValue string amp sValueName Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del siguiente valor enumerado en la clave actual Comentarios Invoque esta funci n hasta que devuelva un resultado falso para enumerar todos los valores en la clave actual Antes de invocar esta funci n por primera vez se debe invocar BeginEnumValue Ejemplo 1 KNM Lua API example C 2007 Kaseya AB Demonstrates the Lua Windows Registry interface Reg TLuaRegistry Open the key to enumerat if Reg Open Reg LOCAL MACHINE SOFTWARE Kaseya true then Reg BeginEnumValue bok true repeat sValue bOk sValue Reg EnumValue sValue if bOk then print sValue end until bOk false else print Failed to open the key end GetErrorDescription string GetErrorDescription 83 TLuaRegistry Valores de devoluci n D
66. e memoria autom tica con recolecci n de elementos no utilizados lo que lo hace ideal para configurar generar scripts y crear prototipos con rapidez Nota En esta documentaci n no se abarca el lenguaje Lua Para obtener m s informaci n sobre el lenguaje Lua visite el sitio http www lua org http www lua org Network Monitor y Lua Los clientes pueden usar el lenguaje de script Lua para crear monitores personalizados para probar los sistemas y equipos no admitidos por ninguna soluci n de supervisi n actual En el entorno de desarrollo que proporciona Kaseya se pueden crear y probar nuevos monitores acciones y eventos antes de exportarlos y usarlos en Kaseya Network Monitor Los desarrolladores pueden consultar una amplia biblioteca de clases prefabricadas como clientes SFTP clientes HTTP y administraci n de archivos API de Lua para Network Monitor El entorno de desarrollo incluye las caracteristicas de depurador resaltado de palabras clave ayuda integrada entre otras disponibles en las herramientas de desarrollo mas avanzadas El entorno de desarrollo se puede descargar de nuestra pagina principal en http www kaseya com http www kaseya com File Edit Insertcode Debug View Help LECCE emn e debugging F5 SY Storage item if needed Name Createltem PM_OutOfPaper value false then iNewOutOfPaperValue StorageItem Storage FindItem PM_OutOfPaper value iNumberOfPreviousJobs if StorageI
67. e un resultado verdadero si el valor est presente de lo contrario devuelve un resultado falso Par metros iPermissionsBits contiene un valor decimal que representa el permiso del archivo o el directorio Tama o bool Size int amp iBytesHighDWord int amp iBytesLowDWord Valor de devoluci n Devuelve un resultado verdadero si el valor esta presente de lo contrario devuelve un resultado falso Par metros BytesHighDWord contiene la porci n alta de dword del entero de 64 bits iBytesLow DWord contiene la porci n baja de dword del entero de 64 bits Comentarios El tama o del archivo se informa en bytes como un entero de 64 bits Dado que Lua no cuenta con un tipo de datos entero de 64 bits la informaci n se separ en dos enteros de 32 bits Si el tama o del archivo es de menos de 2 GB iBytesHighDWord siempre es cero SizeMB bool SizeMB unsigned int amp iSizeMB Valor de devoluci n Devuelve un resultado verdadero si el valor est presente de lo contrario devuelve un resultado falso Par metros iSizeMB contiene el tama o del archivo en megabytes Comentarios Se proporciona como una alternativa f cil de usar a la funci n Size Devuelve el tama o del archivo redondeado hacia abajo 97 Capitulo 18 TLuaSFTPClientDirectoryHandle Esta clase se usa junto con las funciones OpenDir ListDir y CloseDir En este capitulo Siguiente aphid eee ga ced de sect dash had
68. end return Enum end Agregar Add const string amp sDisplayValue const string amp sUsageValue Par metros sDisplayValue valor para mostrar como opci n para seleccionar sUsageValue optativo un valor que se utiliza en lugar del valor para mostrar Comentarios El valor sUsageValue se puede usar cuando se tienen valores muy complejos y extensos y es necesario mostrar las opciones de manera m s simple Cuando se lo utiliza el valor sDisplayValue es el valor que se presenta al usuario pero el valor sUsageValue es el valor que usa Network Monitor 16 Capitulo 4 LuaScriptConfigurator Esta clase proporciona una interfaz para crear informaci n de configuraci n que Network Monitor usa para presentar una interfaz de usuario para el script En este capitulo Script de ejemplo OnConfigure 440s4s00unnnennnnnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn en 18 A 41828 5175515570 7 7 carrer ree 18 1 11671 16 16 1188 11 1 anna 19 SEINUMENCLIMHS rer 7 a 19 A a a S 19 SA 20 A A o a 20 SetMINBuildVErSiOn nn nn naar nn cnn 8 ARKEA RENAR ARS 20 Se ree aeaeo
69. end un entero positivo entre 1 y 255 iPacketSize el tama o de los paquetes por enviar un entero entre 0 y 65500 bNoFragment se establece en verdadero para evitar que los paquetes enviados se fragmenten Se produce un error en la funci n y se devuelve un resultado falso si la opci n est establecida y se fragmenta el paquete iTimeoutMs el tiempo m ximo en milisegundos que la funci n espera para que se devuelva el paquete Comentarios Si la funci n bNoFragment se establece en verdadero es posible probar el m ximo tama o de trama para una ruta Ajuste iPacketSize hasta que se produzca un error en la funci n debido a la fragmentaci n 68 TLualCMP EndTrace EndTrace Comentarios Esta funci n realiza una limpieza de los recursos utilizados Se debe invocar para cada invocaci n de BeginTrace NextTraceResult bool NextTraceResult TLualCMPTraceResult Result Valores de devoluci n La funci n devuelve un resultado verdadero mientras haya un resultado disponible Par metros Resultado una variable TLualCMPTraceResult que recibe el resultado para el salto actual Comentarios Para iterar en el conjunto de resultados invoque la funci n hasta que se devuelva un resultado nulo Ping bool Ping TLualCMPPingResult Result int iPacketsToSend int iPacketSize bool bNoFragment int iTimeoutMs Valores de devoluci n La funci n devuelve un activo TLualCMPPingResult que contiene el resultado de la operaci
70. ento de documento XML actual IsValid bool IsValid Valores de devoluci n La funci n devuelve un resultado verdadero si el nodo es v lido y un resultado falso si el nodo no es v lido Comentarios Todas las funciones de b squeda devuelven un activo TLuaXMLNode La funci n IsValid se usa para determinar si la b squeda fue satisfactoria 135 Capitulo 29 TLuaXMLReader Esta clase proporciona funcionalidad basica para analizar y recorrer documentos XML En este capitulo FINAGHIANOde at ee 2 2 138 291919 1 10 12 7 ee A 138 OM at RER PER A OT 138 GetRootNode TLuaXMLReader FindChildNode TLuaXMLNode FindChildNode string sElementName TLuaXMLNode ParentNode Valores de devoluci n Si se encuentra el elemento la funci n devuelve un activo TLuaXMLNode v lido Par metros sElementName el nombre del elemento secundario de ParentNode ParentNode el nodo primario donde se desea buscar Comentarios Tenga en cuenta que la funci n devuelve el primer elemento con el nombre especificado FindNode TLuaXMLNode FindNode string sElementName TLuaXMLNode RootNode Valores de devoluci n Si se encuentra el elemento la funci n devuelve un activo TLuaXMLNode v lido Par metros sElementName el nombre del elemento secundario de ParentNode RootNode el nodo primario para usa
71. es the Lua SFTP client class sftp TLuaSFTPClient hFileHandle TLuaSFTPClientHandle Open the file OR SEEDE OBEN Mowkeecl Meese exe hrilekameie if bok false then SetExitStatus Open failed false return end sTemp Read the first 20 bytes bok sTemp sftp Read hFileHandle 0 20 sTemp if bok false then SetExitStatus Read failed false return end print sTemp Remover bool Remove string sPath Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros sPath la ruta de acceso del archivo que se desea quitar Renombrar bool Rename string sPath string sNewPath Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Parametros sPath la ruta de acceso del archivo existente al que se le desea cambiar el nombre sNew la ruta de acceso con el nuevo nombre de archivo RmDir bool RmDir string sPath 92 TLuaSFTPClient Valor de devoluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros sPath la ruta de acceso al directorio que se desea eliminar Comentarios Esta funci n s lo elimina directorios vac os Escribir bool Write TLuaSFTPClientHandle FileHandle const int Offset string vData Valor de de
72. escripci n del campo Flags indicadores de control de validaci n Consulte los comentarios para obtener informaci n sobre los indicadores Comentarios Estos son los indicadores v lidos Algunos se pueden combinar 18 LuaScriptConfigurator CHECK_NOTHING Se aceptan valores predeterminados de cualquier tipo incluso la ausencia de texto Comprueba si el argumento esta vacio No se puede combinar con CHECK_NOTHING Se debe utilizar con CHECK_NUMERIC Valida que el valor num rico est dentro del intervalo intervalo bajo Se debe utilizar con CHECK_NUMERIC Valida que el valor num rico est dentro del intervalo intervalo alto CHECK_NOT_EMPTY CHECK_RANGE_LOW CHECK_RANGE_HIGH CHECK_NUMERIC Valida que el valor sea num rico real o entero Indica que hay una devoluci n de llamada de enumeraci n con valores id predefinidos disponible para este campo SetCharacterLimits SetCharacterLimits int iArgindex int iMaxCharacters int iMaxVisibleCharacters Parametros iArglndex el identificador devuelto por AddArgument iMaxCharacters cantidad maxima de caracteres de entrada para el argumento iMaxVisibleCharacters la cantidad m xima de caracteres visibles Debe ser igual o inferior a MaxCharacters Comentarios La funci n establece la longitud m xima de un argumento y cu ntos de esos caracteres son visibles en la interfaz longitud del campo de entrada SetNumericLimits SetNumericLimits int iArg
73. evoluci n siempre es una cadena aunque el tipo de propiedad sea por ejemplo un entero o un n mero real Comentarios Recupera un valor de propiedad en el resultado actual Para recuperar el pr ximo valor de la misma propiedad invoque la funci n NextInstance Si NextInstance devuelve un resultado falso no hay m s valores Nextinstance bool NextInstance Valores de devoluci n El resultado es verdadero si se obtiene un nuevo resultado Si no existen m s resultados para la consulta el resultado es falso Comentarios La funci n recupera un nuevo resultado generado por una invocaci n previa de la funci n Execute Se debe invocar esta funci n antes de la primera invocaci n de la funci n GetProperty SetNamespace SetNamespace string sNamespace Par metros sNamespace cadena con espacio de nombres WMI para usar en todas las invocaciones futuras Comentarios El espacio de nombres predeterminado que usa la clase TLuaWMIQuery es root cvmi2 131 Capitulo 28 TLuaXMLNode La clase representa un elemento XML puede contener uno mas elementos secundarios En este capitulo FIMOATUMIOUTO ali PIERRE 134 11010 le alie 19161 ea 134 A A NA 134 611918 A O 7
74. evuelve una cadena que describe el ltimo error detectado cuando se invoca cualquier funci n de la clase Abra bool Open int Key string sKey Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros iKey una clave que representa uno de los sub rboles de registro bCreate una subclave en el sub rbol de registro seleccionado Comentarios La funci n abre una clave del registro en el sub rbol de registro seleccionado Tenga en cuenta que las credenciales del proceso ya sea IDE o Network Monitor pueden restringir el acceso a ciertas claves y sub rboles Las siguientes constantes est n definidas para iKey CLASSES_ROOT CURRENT_CONFIG CURRENT_USER LOCAL_MACHINE PERFORMANCE_DATA USERS ReadValue bool ReadValue string sValueName string amp sData Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por recuperar sData los datos que devuelve la funci n Comentarios La funci n devuelve los datos del valor con el nombre especificado Si el tipo de valor no es una cadena se produce un error en la funci n ReadVa
75. hen sCmd cscript Nologo C temp test vbs n bExec PS ExecuteCommand sCmd if bExec true then sStatus PS GetStdOut bExitStatus true else ssracrus Execcures felled Y ss PSsGeieSieclmicie end else sStatus Failed to open connection PS GetErrorDescription end SetExitStatus sStatus bExitStatus Abra bool Open unsigned short _iPort bool bSecure true int dwWait 2500 const char _pWorkingDir nullptr Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando GetStdErr Par metros iPort puerto TCP que utiliza la administraci n remota de Windows WinRM bSecure cuando se utiliza SSL est establecido en verdadero predeterminado est establecido en falso para las conexiones que no son SSL dwWait el valor de tiempo de espera para una conexi n correcta 78 TLuaPowershell ExecuteCommand ExecuteCommand const char pCommand Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetStdErr Par metros pCommand la cadena de comando Powershell GetStdOut string GetStdOut void Valores de devoluci n Devuelve el resultado est ndar del
76. host remoto GetStdErr string GetStdErr void Valores de devoluci n Devuelve el resultado de error est ndar del host remoto GetErrorDescription string GetErrorDescription void Valores de devoluci n Devuelve la descripci n del error m s reciente generada por el host remoto como una cadena GetErrorCode dWord GetErrorCode void Valores de devoluci n Devuelve el c digo de error m s reciente generado por el host remoto como una cadena 79 Capitulo 15 TLuaRegistry Esta clase proporciona acceso al Registro de Windows Cuando se trabaja con el registro en la documentaci n se utilizan dos t rminos importantes Clave una entidad en el subarbol de registro que puede contener claves y valores secundarios Valor una entidad sin entradas secundarias que contiene datos Los datos pueden ser de diferentes tipos Los tipos compatibles con esta implementaci n son datos en cadena enteros y binarios Todas las operaciones del registro est n relacionadas con el contexto en el que se ejecuta el script Existe s lo una excepci n se da cuando la clase se inicializa en el valor verdadero en ese caso todas las operaciones son relativas al equipo host de Network Monitor Para obtener m s informaci n consulte el script de ejemplo no 2 en esta clase En este capitulo Script de ejemplo TLuaRegistry 400rn400nnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnannnen 82 BeginEnumV alue
77. i n SetValueExpandedString bool SetValueExpandedString string sValueName string sString Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por escribir sString la cadena que se escribir en el valor Comentarios La funci n opera como la funci n SetValue normal con una excepci n La cadena escrita puede contener referencias sin expandir a las variables de entorno por ejemplo PATH 86 Capitulo 16 TLuaSFTPClient Esta clase implementa una clase de cliente SFTP basico En este capitulo Script de ejemplo 11 85 16 nn COM E 7 da adan GOSS DU ligase Aid AEAT CONOCI A adan Great Flia acia Op DT AE O A A a cil Open PORCIO run nen Aa aaa ech Lan Opan FONT E id a A Bild eee Ae de Open FOrAppe nn 86 1 einlesen 0 1 2 24 1 eT Sen a a o S 87 TLuaSFTPClient Script de ejemplo TLuaSFTPClient Demonstrates the Lua SFTP client class Create the client asset sftp TLuaSFTPClient Connect to the remote SFTP server
78. identificador del pr ximo OID en la variable miembro m_sOID en la estructura TLuaSNMPResult No devuelve la cadena del OID completa Cuando se alcanza el final el miembro m_sOID de la estructura TLuaSNMPResult est vac o Comentarios Antes de la primera invocaci n de la funci n Walk el programa debe invocar la funci n BeginWalk para establecer el comienzo de Walk Walk recupera todos los identificadores secundarios y de objetos del OID inicial establecidos por las funciones BeginWalk Ejemplo KNM Lua API example 2007 Kaseya AB Simple example of SNMP interface SNMP TLuasSNMP SNMP Open public sOID iso org dod internet mgmt mib 2 interfaces ifTable ifEntry A repeat until loop Result TLuaSNMPResult SNMP BeginWalk sOID Bepedie Result SNMP Walk sOID SODA ARS Ss OM Pan OMS OMA pele Daca m sData 7 print Sy T Result m isymtaz y Wmicil Reosule m SOLD Wp TLuaSNMPResult TLuaSNMPResult es una clase de s lo lectura devuelta por la funci n Walk Si se modifica se inicia 106 TLuaSNMP una excepci n Miembros de la clase string m_sOID string m_sData int m_iSyntax 107 Capitulo 21 TLuaSSH2Client Esta clase implementa un cliente SSH 2 0 que puede ejecutar comandos en un servidor remoto En este capitulo Script de ejemplo TLuaSSH2Client rana 11
79. ime etrieved during the connect print Certifica GetTime Check time tCertificateExpiryDate te expires Time GetDate iExpiryTime Time Get iOffsetTime if Time Get lt CurrentTime Get then bTestOk false TLuaSocketSecure Time sText Certificate have already expired Time GetDate Time GetTime else i sole Urals r Time lt CurrentTime Get then bTes tok false sText Certificate is about to expire in less than a o INTA cays end end else Failed to open the socket server down 2 if bReportConnectionProblem true then bTestok end false Silex Camo CONCE CO msi end Report status and ex ale SetExitStatus sText bTestOk end Abra int Open int iPort Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iPort el puerto por abrir Cerrar int Close 119 TLuaSocketSecure Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Leer string Read int 15126 Valores de devoluci
80. in E E 97 TLuaSFTPClientAttributes AccessedTime bool AccessedTime TLuaDateTime amp Time Valor de devoluci n Devuelve un resultado verdadero si el valor esta presente de lo contrario devuelve un resultado falso Par metros Time contiene la hora en que se accedi al archivo por ltima vez CreatedTime bool CreatedTime TLuaDateTime amp Time Valor de devoluci n Devuelve un resultado verdadero si el valor esta presente de lo contrario devuelve un resultado falso Par metros Time contiene la hora en que se cre el archivo m q bool Group string amp sGroup Valor de devoluci n Devuelve un resultado verdadero si el valor est presente de lo contrario devuelve un resultado falso Par metros sOwner contiene el nombre del grupo del archivo o directorio ModifiedTime bool ModifiedTime TLuaDateTime 8 Time Valor de devoluci n Devuelve un resultado verdadero si el valor est presente de lo contrario devuelve un resultado falso Par metros Time contiene la hora en que se modific el archivo por ltima vez Propietario bool Owner string amp SOwner Valor de devoluci n Devuelve un resultado verdadero si el valor est presente de lo contrario devuelve un resultado falso 96 TLuaSFTPClientAttributes Par metros sOwner contiene el nombre del propietario del archivo o directorio PermissionBits bool PermissionBits int amp iPermissionsBits Valor de devoluci n Devuelv
81. ionados En este capitulo EEEE EAEE A tg 122 WpCatelte Meet zectescevestsscecchgvvecccchs sztzccbeatecaahstes traen 122 BIELIE ATEI ita elect enc 122 A A TER E SOME AD 123 TLuaStorageltem 222 842 dia 123 TLuaStorage Createltem bool Createltem string sName string sKey string sData NULL int iSize 0 Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros sName el nombre nico del elemento Si el nombre ya est creado se produce un error en la funci n sKey el nombre de clave del elemento que debe ser nico Si ya existe se produce un error en la funci n sData los datos optativos que se relacionan con el elemento 15126 el tama o de los datos S lo se necesita si los datos se proporcionan con la funci n Comentarios La funci n crea un elemento y un subelemento denominado clave El usuario puede relacionar datos con esta clave Los datos se pueden adquirir m s adelante invocando la funci n Findltem Updateltem bool Updateltem string sName string Key string Data NULL int iSize 0 Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros sName el nombre nico del elemento Ya debe existir un elemento con este nombre sName el nombre
82. l this table contains e print Columnes da als tables do il 1ColCcouate elo and GetCol take a 1 based index B GetColType iCurrentCol DB GetCol iCurrentCol Primt column Fr column type and data Yo dcueremecol yes Y ErrorDescription false ErrorDescription false Devuelve la cantidad de columnas en el resultado de una consulta realizada correctamente Conectar bool Connect string sConnectString int iClientType TLuaDB CLIENT_ODBC 30 TLuaDB Valores de devoluci n El resultado es verdadero si la conexi n se ejecut correctamente si ocurri un error el resultado es falso Par metros sConnectString una cadena de conexi n exclusiva del cliente Consulte la secci n de comentarios para obtener m s informaci n iClientType tipo de cliente con el que comunicarse Consulte las opciones a continuaci n Comentarios La cadena de conexi n es exclusiva del cliente A continuaci n encontrar los clientes compatibles actualmente CLIENT _ODBC Ejemplo de cadena de conexi n sConnectString DSN test UID test PWD test Esta cadena de conexi n utiliza un origen de datos con el nombre test proporciona el nombre de usuario UID test y la contrasefia PWD test al DSN Si no se necesita un nombre de usuario o una contrase a la conexi n puede tener el siguiente formato sConnectString DSN test Network Monitor se ejecuta com
83. l cuadro de mensaje se frena la ejecuci n del script hasta que se cierra print print string sText Par metros sText texto que se imprime en la ventana de salida Comentarios Esta funci n se puede utilizar para imprimir texto en la ventana de salida con fines de depuraci n Cuando Network Monitor ejecuta el script el texto impreso con esta funci n no cumple ning n prop sito SetExitStatus SetExitStatus string sString bool bSuccess Parametros sString una cadena que describe el resultado del script bSuccess si es distinto de cero el valor booleano es verdadero se considera que el marco ejecut el script correctamente Si este valor esta establecido en cero el valor booleano es falso tambi n se debe invocar la funci n SetErrorString con una cadena que describa el estado del error Comentarios Se debe invocar esta funci n cuando se produce la salida de un script La funci n comunica a Network Monitor si el script se realiz correctamente o no Si el script se ejecuta en el contexto de agente Network Monitor utiliza el texto proporcionado con la funci n para establecer el texto del ultimo estado en la interfaz SetLastError SetLastError int iErrorCode Par metros iErrorCode un valor entero que corresponde a un c digo de error espec fico de Windows Funciones globales Comentarios Esta funci n establece el ultimo c digo de error que GetLastError puede recuperar mas adelante
84. lndex float fLow float fHigh Parametros iArgindex el identificador devuelto por AddArgument p gina 18 Low intervalo bajo High intervalo alto Comentarios Esta funci n establece el intervalo aceptable de los valores reales y enteros introducidos en el campo El argumento debe tener establecidos los indicadores CHECK_RANGE_LOW y CHECK_RANGE_HIGH SetEntryPoint SetEntryPoint string sName Par metros sName nombre de la funci n de punto de entrada LuaScriptConfigurator Comentarios La funci n registra el nombre de la funci n de punto de entrada Esta es la funci n que Network Monitor invoca como punto de partida de la ejecuci n El valor predeterminado es main SetAuthor SetAuthor string sName Par metros sName nombre del autor del script Comentarios Esta funci n establece el autor del script Se utiliza para fines descriptivos cuando un usuario carga un script de terceros a fin de informarle qui n escribi el script SetDescription SetDescription string sDescription Par metros sDescription una descripci n de la funci n del script Comentarios Mediante la descripci n del script se le debe informar al usuario en pocas lineas cu l es la funci n del script y si este tiene limitaciones conocidas No hay un l mite m ximo de texto pero debe ser breve SetMinBuildVersion SetMinBuildVersion int iMinBuildNumber Par metros iMinBuildNumber el n mero de
85. lue bool ReadValue string sValueName int amp iData 84 TLuaRegistry Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por recuperar iData los datos que devuelve la funci n Comentarios La funci n devuelve los datos del valor con el nombre especificado Si el tipo de valor no es un entero se produce un error en la funci n Read Value string ReadValue string sValueName int amp iSize Valores de devoluci n Se devuelven los datos almacenados en el valor del registro Si se produce un error en la funci n se devuelve una cadena vac a Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sValueName el nombre del valor por recuperar iSize tama o de los datos que devuelve la funci n en bytes Comentarios La funci n devuelve los datos del valor con el nombre especificado Si el tipo de valor no es un entero se produce un error en la funci n El tama o de los datos devueltos se almacena en el par metro iSize Si se produce un error en la funci n el par metro Size se establece en cero SetValue bool SetValue string sValueName string sData int iDataSize Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de
86. lve un activo TLuaDateTime que contiene la hora de la ltima modificaci n del archivo De lo contrario se devuelve un activo TLuaDateTime establecido en 0 Par metros sFilename el nombre del archivo en el directorio actual Comentarios El archivo debe estar en el directorio actual para que esta funci n se ejecute correctamente Las rutas de acceso relativas no funcionan 57 TLuaFTPClient GetFileSize int GetFileSize string sFilename Valores de devoluci n Se devuelve el tama o del archivo en cantidad de bytes si la funci n se ejecuta correctamente Si no se puede acceder al archivo el valor de devoluci n es 1 Par metros sFilename la ruta de acceso y el nombre del archivo Comentarios La funci n se limita a archivos con menos de 231 bytes OpenFile int OpenFile string sFilename bool bWrite bool bText Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFilename el nombre del archivo que se desea abrir bWrite si es un valor distinto de cero el archivo se abre en modo de escritura Si el valor es cero el archivo se abre en modo de s lo lectura bText si es un valor distinto de cero el archivo se abre en modo de traducci n de texto De lo contrario se abre en modo binario Comentarios La funci
87. mentos que la aplicaci n de llamada transmite al programa Comentarios Una aplicaci n de llamada puede transmitir una cantidad de argumentos al script Lua para personalizar su comportamiento Con esta funci n el programador puede determinar la cantidad de argumentos que hay para extraer GetLastError int GetLastError Valores de devoluci n El ltimo c digo de error generado por invocaci n a una funci n de biblioteca El c digo de error es un c digo de error est ndar de Windows Comentarios La funci n SetLastError se puede usar para borrar el c digo de error de Windows actual antes de invocar una funci n sds GetDeviceAddress string GetDeviceAddress Valores de devoluci n La direcci n introducida en el campo de direcci n del dispositivo Comentarios La cadena se puede usar como identificador nico en el momento de guardar datos en TLuaStorage 510 bool IsIDE Valores de devoluci n El valor booleano es verdadero si el IDE ejecuta el script y es falso si Network Monitor ejecuta el script Comentarios Se pueden utilizar estas funciones si Network Monitor o el IDE ejecutan el script Funciones globales MessageBox MessageBox string sText Par metros sText texto que se muestra en el cuadro de mensaje Comentarios Esta funci n invoca que se muestre una cadena en un cuadro de mensaje est ndar del SO Esta funci n s lo est disponible en el IDE Observe que cuando se muestra e
88. n Par metros iPacketsToSend un entero positivo entre 1 y 255 iPacketSize el tama o de los paquetes por enviar un entero entre 0 y 65500 bNoFragment se establece en verdadero para evitar que los paquetes enviados se fragmenten Se produce un error en la funci n y se devuelve un resultado falso si la opci n est establecida y se fragmenta el paquete iTimeoutMs el tiempo m ximo en milisegundos que la funci n espera para que se devuelva el paquete Comentarios Si establece el argumento bNoFragment se puede probar el m ximo tama o de trama posible para una ruta 69 Capitulo 12 TLualCMPPingResult TLualCMPPingResult es una clase de s lo lectura Miembros de la clase intm_iRoundTripTimeMs float m_fPacketloss 71 Capitulo 13 TLualCMPTraceResult TLualCMPTraceResult es una clase de s lo lectura Miembros de la clase string m_IP string m_Hostname int m_iRoundTripTimeMs 73 Capitulo 14 TLuaPowershell Ejecuta una cadena de comando Powershell Devuelve un resultado de comando Powershell un resultado de error c digos de error y descripciones de error estandar Requisitos previos La biblioteca TLuaPowershell utiliza WinRS Shell remoto de Windows para conectarse a un activo habilitado para Administraci n remota de Windows Informacion de Microsoft sobre WinRM WinRS http msdn microsoft com en us library aa384426 28v vs 85 29 aspx La Administraci n remota de Windo
89. n Si la funci n se ejecut correctamente devuelve una matriz de datos De lo contrario si no se puede leer ning n dato no devuelve nada Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iSize cuando la invocaci n de la funci n devuelve la variable se establece en el tama o de los datos le dos Si no se leyeron datos este valor es cero Escribir int Write string Data int iSize Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sData una matriz con datos por enviar 15126 el tama o de los datos en la matriz GetCertificateExpiryDate TLuaDateTime GetCertificateExpiryDate Valores de devoluci n Una estructura TLuaDateTime que contiene la fecha de caducidad del certificado del host remoto Si se produce un error en la invocaci n de Connect la estructura contiene una fecha en cero Comentarios Esta funci n se puede usar para determinar si un certificado est por caducar o ya caduc 120 Capitulo 24 TLuaStorage La clase proporciona funciones para guardar datos textuales entre sesiones de script Puede ser util cuando se desea basar la iteraci n del script actual en un resultado previo o establecer una comunicaci n entre dos scripts que no estan relac
90. ndo la funci n global GetLastError Par metros sDirectory la ruta de acceso del directorio por buscar Comentarios La cadena de retorno contiene todos los subdirectorios en el directorio especificado Cada directorio se devuelve con su ruta de acceso completa Los directorios de la cadena est n separados por un car cter de retorno de carro GetFileAccessedTime TLuaDate Time GetFileAccessedTime string sFilename Valores de devoluci n Devuelve un activo TLuaDate Time que contiene la hora en que se accedi al archivo por ltima vez De lo contrario devuelve un activo TLuaDate Time que contiene el valor 0 Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFilename la ruta de acceso y el nombre del archivo Comentarios Usa el activo TLuaDateTime para construir una cadena que representa el tiempo almacenado en el activo o lo compara con otro activo TLuaDateTime 46 TLuaFile GetFileCreatedTime TLuaDateTime GetFileCreatedTime string sFilename Valores de devoluci n Devuelve un activo TLuaDate Time que contiene la hora en que se cre el archivo De lo contrario devuelve un activo TLuaDate Time que contiene el valor 0 Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros pFilename la ruta de acceso y el nombre del archivo Comentarios Usa el activo TLuaDateTime para construir una cadena que represent
91. ntrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sDirectory ruta de acceso del directorio por borrar Comentarios El directorio no puede estar vac o y no puede ser un directorio ra z o el directorio de trabajo actual DeleteFile int DeleteFile string sFileName Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFileName la ruta de acceso y el nombre del archivo por eliminar Comentarios La funci n elimina un archivo No se pueden eliminar directorios con esta funci n 45 TLuaFile DoesFileExist int DoesFileExist string sFile Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sFile la ruta de acceso y el nombre del archivo Comentarios Si existe el archivo devuelve un valor distinto de cero GetDirectoryList string GetDirectoryList string sDirectory Valores de devoluci n Devuelve una cadena con los subdirectorios separados por un car cter de retorno de carro de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invoca
92. o un servicio El origen de datos debe ser un origen de datos de sistema Esto es distinto del IDE que tambi n puede usar un usuario DSN CLIENT _SQLSERVER Ejemplo de cadena de conexi n sConnectString myserver mydatabase Para conectar una instancia con nombre de SQL Server 2000 use lo siguiente sConnectString myserver instance name mydatabase CLIENT_MYSQL Ejemplo de cadena de conexi n con el uso del puerto 3306 predeterminado sConnectString myserver mydatabase Conexi n a un servidor que escucha un puerto predeterminado sConnectString myserver portnumber mydatabase Tenga en cuenta que se debe instalar la biblioteca de cliente MySQL MySQL Workbench o Connector C libmysql y se la debe incluir en la variable PATH predeterminada del sistema Windows para que Network Monitor y el IDE la puedan encontrar Connect 2 bool Connect string sConnectString string sUser string sPassword int iClientType TLuaDB CLIENT_ODBC Valores de devoluci n El resultado es verdadero si la conexi n se ejecut correctamente si ocurri un error el resultado es falso 31 TLuaDB Parametros sConnectString una cadena de conexi n exclusiva del cliente Consulte la secci n de comentarios para obtener m s informaci n sUsername credenciales para usar con la conexi n sPassword credenciales para usar con la conexi n No puede estar vac o si se especifica un nombre de usuario iClien
93. or o igual de lo contrario es falso Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye No igual a bool NotEqual TLuaDateTime DateTime 27 TLuaDateTime Valores de devoluci n El resultado es verdadero si DateTime no es igual de lo contrario es falso Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye Establecer Set int NewTime Par metros iNew la compensaci n de tiempo en segundos o el tiempo absoluto en segundos desde el 1 de enero de 1970 Comentarios Esta funci n se puede usar para crear una instancia de TLuaDateTime que despu s se suma a otra instancia de TLuaDateTime se resta de ella o se compara con ella Sub Sub TLuaDateTime DateTime Par metros DateTime instancia de TLuaDateTime que se obtiene de otra funci n de clase o se construye Comentarios La funci n resta la hora contenida en el par metro DateTime de la hora almacenada en el activo 28 Capitulo 6 TLuaDB Esta clase proporciona funciones para consultar bases de datos SQL En este capitulo Script de ejemplo TLuaDB ooooocnnnccccncconoccnoncccnonocononn conc cnn cnn ncannn rca 30 GOICOUMT arta A dn ta ea apa 30 GONCCtAR i Ad in eran eae eae 30 RIELE e E AE A is aa 31 EEN e di tee 32 EIE
94. os se almacenaron correctamente en la base de datos estad stica resultado falso si hay un error de par metro Par metros iRecordSetindex un indice de base cero del canal estad stico en el que se almacenan los datos Consulte los comentarios para obtener constantes v lidas fData datos de punto flotante que muestrea el script fThreshold valor de umbral optativo para los datos de ejemplo Este valor debe ser constante en todas las llamadas iVirtualType tipo de datos almacenados Funciones globales iVirtualUnit unidad seleccionada del tipo almacenado Consulte los comentarios para obtener combinaciones v lidas de tipos y unidades Unit cadena optativa que describe la unidad de los datos Este valor debe ser constante en todas las llamadas La cadena puede tener 16 caracteres como m ximo De lo contrario la invocaci n falla Comentarios Esta funci n s lo est disponible para scripts avanzados La diferencia entre esta funci n y la funci n anterior con el mismo nombre es la capacidad de almacenar informaci n de tipo con los datos VirtualType e VirtualUnit se pueden utilizar en las siguientes combinaciones 12 VT_SWAP_UTII VT_MEMORY UTIL Wr D wie UN TILIZA LIZATION IZATION SK_UTILIZATION TION 1 hal ll le T TYPE PE RCENT We is UNIT TYPE ME UNIT TYPE GI UNIT TYPE TE REE DISKSPACE GABYTE GABYTE
95. pecificado OpenUDP int OpenUDP int iPort Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iPort un puerto espec fico para usar con el socket Comentarios Abre un socket UDP con el n mero de puerto especificado Leer string Read int iSize int iTimeout 1 Valores de devoluci n Si la funci n se ejecut correctamente devuelve una matriz de datos De lo contrario si no se puede leer ning n dato no devuelve nada Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iSize cuando la invocaci n de la funci n devuelve la variable se establece en el tama o de los datos le dos Si no se leyeron datos este valor es cero iTimeout la cantidad de tiempo en segundos que se espera que los datos lleguen al socket El valor predeterminado es un segundo Comentarios La funci n s lo bloquea la ejecuci n durante la cantidad de tiempo especificada por el valor de tiempo de espera Si no se reciben datos durante ese per odo la funci n devuelve un valor nulo Escribir int Write string Data int iSize Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec
96. pen Reg LOCAL MACHINE SOFTWARE Kaseya KNM true then sValue wn r bOK sValue Reg ReadValue INSTALL SHORTCUTFOLDER sValue I SetExitStatus KNM install path is gt sValue bOK else SetExitStatus Could not open registry location false end BeginEnumValue BeginEnumValue Comentarios Se debe invocar esta funci n antes de la primera invocaci n de EnumValue Esta funci n asegura que EnumValue comience en la parte superior de la lista de valores Si no se invoca esta funci n antes de EnumValue se producen resultados impredecibles Cerrar Close Comentarios La funci n cierra la conexi n al registro actualmente abierta Crear bool Create string sKey Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar una descripci n del error invocando GetErrorDescription Par metros sKey una clave por crear Comentarios La funci n Create crea la clave del registro especificada Si la clave ya existe en el registro la funci n la abre Esta funci n puede usarse para crear varias claves a la vez Por ejemplo se puede crear una subclave de tres niveles con un script al especificar una cadena de la siguiente forma subclave1 subclave2 subclave3 82 TLuaRegistry DeleteValue bool DeleteValue string sValueName Valores de devoluci n Si la funci n s
97. r como punto de partida de la b squeda Comentarios La funci n busca el documento XML de forma recursiva con RootNode como punto de partida de la b squeda FromXML bool FromXML string XML Valores de devoluci n El resultado es verdadero si la operaci n se ejecut correctamente si ocurri un error el resultado es falso Par metros sXML un documento XML para analizar Comentarios Tenga en cuenta que el analizador no valida el esquema del documento GetRootNode TLuaXMLNode GetRootNode 138 TLuaXMLReader Valores de devoluci n La funci n devuelve el elemento ra z del documento XML 139 Indice A Abra 49 78 84 105 111 119 AccessedTime 96 AddArgument 18 Agregar 16 24 API de Lua para Network Monitor 1 B BeginEnumValue 82 BeginTrace 68 BeginWalk 104 Cerrar 44 55 63 82 88 104 114 119 Ch ChangeDirectory 54 CloseDir 88 CloseFile 55 ColCount 30 Comenzar 36 Conectar 30 55 62 89 Connect 2 31 Contexto de activos 6 ConvertFromUTF16 8 CopyFile 44 Crear 24 82 CreateDirectory 45 55 CreatedTime 96 CreateFile 89 Createltem 122 CreateSpan 24 D DeleteDirectory 45 56 DeleteFile 45 56 Deleteltem 122 DeleteValue 83 Detener 126 DoesFileExist 46 E Ejecutar 32 130 EndTrace 69 EnumValue 83 Escribir e 51 59 93 115 120 Establecer 28 105 ExecuteCommand 79
98. r el cliente como una cadena GetStdErr string GetStdErr void Valores de devoluci n Devuelve el resultado de error est ndar del host remoto GetStdOut string GetStdOut void Valores de devoluci n Devuelve el resultado est ndar del host remoto 110 TLuaSSH2Client Abra bool Open int iPort Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n GetErrorDescription Si se produce un error como resultado del comando se puede recuperar m s informaci n invocando GetStdErr Parametros iPort puerto SSH El puerto predeterminado es 23 sUsername nombre de usuario sPassword contrase a 111 Capitulo 22 TLuaSocket Esta clase proporciona operaciones de socket basicas Los sockets se pueden abrir en modo UDP o TCP En este capitulo Script de ejemplo 11 850 8 61 114 GOLAN cba sacar NEEE OR IE FEN END 114 Open A setter eee ridad 114 OpeanUDP ara lada 115 0 1 RER EIER 7
99. ramaci n Script avanzado El modelo de script avanzado le brinda al autor nuevas herramientas eficaces para controlar los parametros que se dan como argumentos al script Esto permite que se creen scripts Lua que tengan el mismo aspecto que los tipos de monitores nativos Nombres de funci n reservados Existen dos nombres de funci n reservados que utiliza Network Monitor para consultar informaci n Estos nombres de funci n no se pueden utilizar para ning n otro prop sito OnConfigure Network Monitor invoca esta funci n para que el script rellene una instancia de clase LuaScriptConfigurator La informaci n se utiliza luego para crear una interfaz de usuario para el script El nombre de la instancia debe ser Config tenga en cuenta la may scula para que Network Monitor pueda encontrarla en la pila de Lua cuando se devuelva la funci n OnEnumerate Se pueden enumerar todos los campos en la interfaz de usuario Network Monitor invoca la funci n OnEnumerate para que el script rellene una estructura de datos LuaScriptEnumResult con valores que selecciona el usuario La funci n OnEnumerate tiene un par metro sFieldToEnum que el script usa para determinar a qu campo o argumento proporcionarle los resultados de la enumeraci n La instancia devuelta se debe denominar Enum tenga en cuenta la may scula El punto de entrada El modelo de script avanzado requiere que la funci n OnConfigure establezca el nombre de la
100. s de registros incluidos en la secci n de comentarios bBypassCache es falso como opci n predeterminada Si se establece en verdadero la consulta omite la resoluci n local y realiza la consulta directamente al servidor DNS Comentarios La funci n env a una consulta al servidor DNS Los resultados se pueden extraer con una invocaci n o m s de la funci n Next Se pueden invocar los siguientes tipos de registros LuaDNS_TYPE_PTR LuaDNS_TYPE_TEXT LuaDNS_TYPE_SOA LuaDNS_TYPE_CNAME LuaDNS_TYPE_MX LuaDNS_TYPE_NS LuaDNS_TYPE_A Puede encontrar referencias sobre tipos de registros DNS en la siguiente direcci n http www iana org assignments dns parameters http www iana org assignments dns parameters 37 TLuaDNS TLuaDNS_ ARecord Miembros de la clase intm_iTTL string m_sIPAddress TLuaDNS_CNAMERecord Miembros de la clase intm_iTTL string m_sHostname TLuaDNS_MXRecord Miembros de la clase intm_iPreference string m_sNameExchange TLuaDNS_NSRecord Miembros de la clase intm_iTTL string m_sHostname TLuaDNS_PTRRecord Miembros de la clase intm_iTTL string m_sHostname TLuaDNS SOARecord Miembros de la clase intm_iTTL string m_sPrimaryServer string m_sAdministrator intm_iSerialNo intm_iRefresh intm_iRetry intm_iExpire intm_iDefaultTTL 38 TLuaDNS TLuaDNS_ TXTRecord Miembros de la clase int StringCount void string GetS
101. suponer un problema dado que la funci n Get devuelve una cadena terminada en cero Una soluci n para este problema es establecer la variable iSyntax en SNMP_DATA_AS_HEXSTRING De esta manera la funci n devuelve los datos binarios cifrados en formato hexadecimal Ejemplo de tres bytes cifrados en formato hexadecimal 49 4E4D Abra bool Open string sCommunity int iPort 161 Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sCommunity el nombre de la comunidad por lo general p blico Port optativo especifique el n mero de puerto si necesita usar un puerto distinto del est ndar puerto 161 Establecer bool Set string sOID string sData int iSyntax Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero 105 TLuaSNMP Par metros sOID OID para usar en la operaci n set sData los datos textuales que se usan en la operaci n set iSyntax especifica el formato del par metro sData Puede ser una de las siguientes constantes SNMP_NOSYNTAX SNMP_IPADDRESS SNMP_INTEGER SNMP_UNSIGNED32 SNMP_COUNTER32 SNMP_GAUGE32 SNMP_TIMETICKS SNMP_OPAQUE SNMP_OCTETSTRING LN NNN NNN A Walk TLuaSNMPResult TLuaSNMP Walk Valores de devoluci n Devuelve el
102. t Deviceid Size Freespace from win32 logieald sk print Query GetErrorDeseription while Query NextInstance do sDeviceID bOk sDeviceID Query GetProperty Deviceid sDevicelD print sDevicelD end Ejecutar bool Execute const char pWQL bool Execute const char pWQL const int iPrivacy Valores de devoluci n El resultado es verdadero si la consulta se ejecut correctamente si ocurri un error el resultado es falso Par metros sWQL una cadena que contiene una consulta WQL Comentarios Ejecuta una consulta WQL lenguaje de consulta de WMI Invoca Next se puede usar GetProperty para recuperar el resultado GetErrorDescription string GetErrorDescription Valores de devoluci n Devuelve una cadena que describe el ltimo error detectado cuando se invoca cualquier funci n de la clase Es til para la depuraci n de consultas de WMI GetProperty bool string GetProperty string sPropertyName string sReturnValue Valores de devoluci n Si la funci n se ejecuta correctamente devuelve un resultado verdadero y un valor en una cadena Si se produce un error en la funci n devuelve un resultado falso y una cadena vac a Se puede recuperar informaci n m s detallada sobre el error invocando GetError Par metros sPropertyName el nombre de la propiedad por recuperar 130 TLuaWMIQuery sReturnValue la cadena definida que recibe el valor de devoluci n El valor de d
103. tAvilable bool ResultAvilable Valores de devoluci n El valor devuelto es verdadero si una instrucci n SQL ejecutada devuelve cualquier resultado Comentarios Tal como fue dise ada no inserta actualiza ni elimina instrucciones que devuelven cualquier resultado despu s de la ejecuci n Antes de invocar esta funci n se debe usar el valor de devoluci n de la funci n Execute para determinar si se ejecut correctamente una instrucci n 34 Capitulo 7 TLuaDNS Esta clase proporciona funciones para consultar servidores DNS En este capitulo Script de ejemplo TLUADNS cceecceceeeeeeceeeeeee eee eeeaaeseeeeeseeeeeeaaeeeeaaeeeeeeescaeeeeaeeeeneeee GCOMENZ AN ati seces fens A A a aa 35 TLuaDNS Script de ejemplo TLuaDNS DNS TLuaDNS DNS Begin true if DNS Query microsoft com TLuaDNS LuaDNS TYPE MX false then Record TLuaDNS_MXRecord while DNS Next Record do print Record m_sNameExchange end Seuiralesiceic s CURE Sie al ene y else Sciek sabe Sie aie US reste Fedlecd relse end Comenzar bool Begin bool bUselocalhost false Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros bUselocahost se establece en verdadero si se desea hacer una consulta al servidor DNS en el equipo host de Network Monitor Comentarios La funci n inicia una consulta DNS Invocar la f
104. tType tipo de cliente con el que comunicarse Actualmente la nica opci n es CLIENT_ODBC Comentarios La cadena de conexi n es exclusiva del cliente Consulte Conectar p gina 30 para obtener m s informaci n Ejecutar bool Execute string sSQL Valores de devoluci n El resultado es verdadero si la consulta se ejecut correctamente si ocurri un error el resultado es falso Par metros sSQL una instrucci n SQL Comentarios Si ocurre un error al ejecutar una instrucci n SQL la funci n GetErrorDescription devuelve una cadena con una descripci n del error GetCol string GetCol int ilndex Valores de devoluci n Devuelve una cadena con los datos recuperados de la columna Par metros ilndex un ndice de columna de base 1 Comentarios Tenga en cuenta que el ndice de columna es de base 1 Si ColCount devuelve el n mero 10 el intervalo de ndices v lido es 1 10 Para recuperar el tipo de datos invoque la funci n GetColType GetCol_AsDateTime TLuaDateTime GetCol_AsDateTime int ilndex Valores de devoluci n Devuelve una estructura TLuaDateTime con la fecha y la hora recuperadas de la columna 32 TLuaDB Par metros ilndex un ndice de columna de base 1 Comentarios Tenga en cuenta que el ndice de columna es de base 1 Si ColCount devuelve el n mero 10 el intervalo de ndices v lido es 1 10 Esta funci n no se debe invocar si la columna no es de tipo de fecha
105. tem m_pData nil then iOutOfPaperValue i0utO0fPaperValue tonumber StorageItem m pData PrinterName brother end iNumberOfCurrentlobs 0 else gt No item found this is the first test since creation of monitor or restart of INM bFirstTest true end Create a new storage item if needed if Storage CreateItem PM_Jobs value false then Storageltem Storage FindItem PM_Jobs valuer if StorageItem m_pData nil then iNumberOfPreviousJobs tonumber StorageItem m pData end end Winperf TLuaWinperf Get the printer out of paper value iNewOutOfPaperValue Winperf Getkesult Get the number of jobs on printer if Winperf Query Print Queue Jobs PrinterName true then iNumberOfCurrentJobs Winperf GetResult else Line Current selected host Dreskpoint active Debugger started Breakpoint active Breakpoint active SEE IDE Lua v3 Capitulo 1 Modelo de programaci n Cuando se crea un script Lua personalizado para usar con Kaseya Network Monitor el script debe cumplir una cantidad de requisitos para que Kaseya Network Monitor lo pueda ejecutar correctamente En este cap tulo Scrpt aVanzadO a ii eh iria aves ede 4 SCAPESIMPIS Lai diia aliada 6 Gontexto de aclVOS huele 6 Resultador ii IE IL E SERIE ENTE 6 Modelo de prog
106. th 3 values Config AddArgument Argument 2 This is the description of thesecond argument LuaScriptConfigurator CHECK NOT _EMPTY LuaScriptConfigurator ENUM AVAIL Set the entry point this is the function called by KNM Config SetEntryPoint main Done with configuration return the asset return Config end This is the entry point Modelo de programaci n function main sFirstArgument GetArgument 0 sSecondArgument GetArgument 1 SetExitStatus OK true end Script simple El modelo de script simple se utiliz6 en Network Monitor desde la primera version y ahora debe considerarse obsoleto Se mantiene por cuestiones de compatibilidad con scripts mas antiguos Contexto de activos Las funciones son relativas al contexto de los activos Todas las llamadas que acceden a recursos son relativas al activo primario Por ejemplo si el script abre un archivo la ruta que se proporciona a la funci n de apertura debe ser relativa al activo Ejemplo Establezca la direcci n del equipo Windows servidordedominio como host TMLee aL hee oem YC Meses ese y Al invocar la funci n el script abre el archivo test txt ubicado en el disco duro C de la computadora servidordedominio Esta tambi n es la raz n por la cual todas las clases relacionadas con la comunicaci n como TLuaFTPClient TLuaHTTPClient y TLUASocket s lo tienen un argumento de numero de puerto el marco codific
107. tring int iPos 39 Capitulo 8 TLuaFile Esta clase proporciona rutinas basicas de manejo de archivos y es compatible con archivos binarios y de texto Todas las operaciones de archivos estan relacionadas con el contexto en el que se ejecuta el script Por ejemplo si un activo ejecuta el script con la direcci n myserver la ruta de acceso del archivo c test txt se traduce como myserver C test txt Existe s lo una excepci n se da cuando la clase se inicializa con el valor verdadero En ese caso todas las operaciones se relacionan con el equipo host de Network Monitor Para obtener mas informaci n consulte el script de ejemplo no 3 en esta clase En este cap tulo Scripts de muestra TLuafile ooooonnicicnidinnncnnnnnnnncconorcnnrcnnnnncnnarccn arrancar anna 43 A T 44 OPV File 44 Greate DIFGCLONY coda 45 Delete DireclOry seras 45 DG Ste File titanic 45 DOGSFIGEXISE 44 25 00 tte de 46 GetDirectoryliSt anti 46 CAN 46 39 6 6 0 6 aran anno nn nn nana nana na rana n cara nenn 47 26 161181 een een 47 GetFileModifiedTime ooccccccccncnoncccncnonononononancnnno
108. uede recuperar un c digo de error espec fico invocando la funci n global GetLastError 54 TLuaFTPClient Par metros sDir la ruta de acceso del nuevo directorio actual Comentarios Si no existe el directorio se produce un error en la funci n Cerrar Close Comentarios La funci n cierra la conexi n actual al servidor FTP Se debe invocar la funci n para cerrar la conexi n actual CloseFile void CloseFile Comentarios Cierra un archivo abierto con OpenFile Conectar bool Connect unsigned int iPort 21 Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sUsername cadena que contiene el nombre de usuario sPassword cadena que contiene la contrase a iPort puerto predeterminado 21 puerto FTP est ndar Comentarios La funci n establece una conexi n a un servidor FTP con el nombre de usuario y la contrase a proporcionados Si el servidor FTP est asociado a otro puerto se puede modificar el puerto predeterminado 21 CreateDirectory int CreateDirectory string sDir Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError 55 T
109. uede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros sData la matriz de datos por escribir en el archivo 15126 el tama o de la matriz por escribir Comentarios Si no se abri un archivo o si el archivo est abierto en modo de s lo lectura se produce un error en la funci n Tambi n se puede producir un error en la funci n si el espacio de almacenamiento en el servidor FTP est agotado 59 Capitulo 10 TLuaHTTPClient Esta clase implementa un cliente HTTP basico En este capitulo Script de ejemplo TLuaHTTPClient 220040nnnnennnnennnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn en 62 Conectar ee ee re 62 GOVAN ceases cc cece E A Dn aa 63 ET ar ase E SE AO 63 POS tes ieee AT E achat ne ee 63 GEG OMS EIES concoct aah ta A beets 64 CA A 64 GetHeaderLocati0N oooccccccccccncnoncccnncnnnnononananannco nono nnnnnn 64 GetHeaderContentlengtn rca rra nen 65 GetHeaderContent Type
110. unci n Query antes de que se ejecute Begin puede dar resultados desconocidos Final void End Comentarios Esta funci n finaliza una transacci n y restablece el activo para que se pueda ejecutar una nueva consulta Si no se invoca esta funci n el resultado de la siguiente consulta es impredecible GetErrorDescription string GetErrorDescription void Valores de devoluci n Devuelve la descripci n del error m s reciente generada por la API de TLuaDNS 36 TLuaDNS Siguiente bool Next TLuaDNS_NSRecord Record bool Next TLuaDNS_CNAMERecord Record bool Next TLuaDNS_ARecord Record bool Next TLuaDNS_PTRRecord Record bool Next TLuaDNS_SOARecord Recora bool Next TLuaDNS_MXRecord Record bool Next TLuaDNS_TXTRecord Record Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros Registro de tipo DA DNS que recibe la informaci n sobre la que se consult al servidor DNS Comentarios La funci n devuelve un resultado verdadero si recuper correctamente un nuevo registro si la funci n devuelve un resultado falso no hay m s registros para recuperar Query bool Query string sDomainName int iRecordType bool bBypassCache false Valores de devoluci n Valor distinto de cero si la funci n se ejecut correctamente de lo contrario devuelve cero Par metros sDomainName el dominio para consultar iRecordType uno de los tipo
111. ve una cadena De lo contrario no devuelve nada Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iSize el tama o de los datos por leer en bytes Comentarios Esta funci n lee el tama o especificado de los datos en el archivo y mueve el puntero a archivo hacia delante la misma cantidad Si se llega al final del archivo se frena la lectura y se devuelven los datos que se leyeron hasta que se lleg al final del archivo 49 TLuaFile ReadData local data int ReadData int iSize Valores de devoluci n La funci n devuelve un tipo de datos especial que s lo se puede utilizar junto con ConvertFromUTF16 Si la funci n se ejecut correctamente Size se establece en el tama o de los datos devueltos De lo contrario no devuelve nada Se puede recuperar un c digo de error espec fico invocando la funci n global GetLastError Par metros iSize el tama o de los datos por leer en bytes Comentarios Esta funci n lee el tama o especificado de los datos en el archivo y mueve el puntero a archivo hacia delante la misma cantidad Si se llega al final del archivo se frena la lectura y se devuelven los datos que se leyeron hasta que se lleg al final del archivo RenameFile int RenameFile string sOrgFile string sNewFile Valores de devoluci n Si la funci n se ejecut correctamente devuelve un valor distinto de cero de lo contrario devuelve cero Se puede re
112. vo Si es necesario extiende el archivo cuando pasa el final del archivo actual Si el archivo abierto est protegido contra escritura se produce un error en la funci n 51 TLuaFile 52 Capitulo 9 TLuaFTPClient Esta clase implementa un cliente FTP con capacidad para operaciones FTP basicas En este capitulo Script de ejemplo TLuaFTPClient 22004440nnnnnnnnnnnnnnnnannnnnnnnnnnnnnnnnnnnnnnnnn nen 54 GhangeDirectory ici da aida 54 Ba A ait acta tag va ta Diada 55 Closer ic A aera 55 CONO dd a Diada 55 GreateDirECctO Et a sh adnate ese 55 Delete DIECON acicate 56 Delete File eenaa E E E AEE 56 FINODIECTO oreraa a AE EAA TE A 56 5217512111 22222 ae ads 57 GetCurrentDirectory aaas aaar ren 57 GetFileModifiedTime 57 GOtRIIGSIZ o aise coat a 58 OBENHEIOr Asa a career creer ee 58 LEGON Sica aa 58 A 59 ESCHIDIL rs o A mt eno e AO Pn IE HE 59 TLuaFTPClient Script de ejemplo TLuaFTPClient Script connects to a FTP server and download content of file fus Miuspmac li cm
113. voluci n Devuelve un resultado verdadero si la operaci n fue satisfactoria de lo contrario devuelve un resultado falso Par metros FileHandle identificador del archivo abierto anteriormente iOffset desplazamiento en bytes desde donde escribir en el archivo sData la cadena de texto por escribir Ejemplo KNM Lua API example C 2010 Kaseya AB Demonstrates the Lua SFTP client class sftp TLuaSFTPClient hrileHandle TLuaSFTPClientHandle Open the file hrileHandle TLuaSFTPClientHandle Lif srussOpea ForWrite test tzt false chen SetExitStatus Open of file failed false return end Create a string and write it to the begining of the file sString test text if sftp Write hFileHandle 0 sString false then SetExitStatus Write failed false return end Close the file sftp Close hFileHandle 93 Capitulo 17 TLuaSFTPClientAttributes Esta clase contiene atributos que describen un directorio o un archivo recuperado por la funci n ListDir En este cap tulo NAT AA 96 AAN 96 Mi mediar ata dla T E 96 Modified TIME oooccccccccccnonoccncnnnononononocononnnononononaconnno conocen nan nc 96 219161 2 18 9 7 O 96 PermissionBilszmn 97 TAMANO sta
114. ws WinRM es la implementaci n de Microsoft del protocolo WS Management un protocolo est ndar basado en el protocolo simple de acceso a objetos SOAP compatible con firewall que permite la interoperaci n de hardware y sistemas operativos de distintos proveedores Puede usar objetos de scripting de WinRM la herramienta de l nea de comandos de WinRM o la herramienta WinRS de l nea de comandos de Shell remoto de Windows para obtener datos de administraci n de equipos locales y remotos que pueden tener controladores de administraci n de placa base BMC Si en la computadora se ejecuta una versi n de sistema operativo basado en Windows que incluye WinRM el Instrumental de administraci n de Windows WMI proporciona los datos de administraci n Para habilitar WinRM en un activo escriba lo siguiente en el s mbolo del sistema winrm quickconfig Puede ejecutar comandos Powershell o ejecutar scripts pero recuerde que los comandos o los scripts que se ejecuten mediante WinRS no deben tener dependencias de interfaces de usuario Por ejemplo no puede ejecutar comandos que le soliciten presionar cualquier tecla en la consola local o que requieran cualquier otra respuesta interactiva En este cap tulo Script de ejemplo TLuaPowershell nn nano cnn narran anna nnccns 77 Script de ejemplo TLuaPowershell Windows Scripting 220444400nnn nenne 78 ADlasanii
115. y hora GetColType int GetColType int ilndex Valores de devoluci n Devuelve un entero que representa el tipo de datos que contiene la columna Par metros ilndex un ndice de columna de base 1 Comentarios La funci n GetCol siempre devuelve los datos en forma de cadena La funci n GetColType determina el tipo de datos en que se puede convertir la cadena despu s de la extracci n Existen los siguientes tipos TYPE_BOOL valor booleano TYPE_NUMERIC num rico TYPE_SHORT breve TYPE_LONG extenso TYPE_DOUBLE doble real TYPE_DATETIME fecha y hora TYPE_STRING cadena TYPE_UNKNOWN tipo de campo desconocido incompatible TYPE_BYTES bytes TYPE_LONG_BINARY binario extenso TYPE_LONG_CHAR caracteres extenso TYPE_BLOB dispositivo binario TYPE_DBMS_SPECIFIC datos exclusivos del cliente sin conversi n GetErrorDescription string GetErrorDescription void Valores de devoluci n Devuelve la descripci n del error m s reciente generada por la API de TLuaDB NextRow bool NextRow 33 TLuaDB Valores de devoluci n El resultado es verdadero si se obtiene un nuevo resultado Si no existen m s resultados para la consulta el resultado es falso Comentarios La funci n recupera un nuevo resultado generado por una invocaci n previa de la funci n Execute Esta funci n se debe invocar antes de la primera invocaci n de las funciones ColCount GetCol o GetColType Resul

Network Monitor API

Contents

Download Pdf Manuals

Related Search

Related Contents