|
<< Click to Display Table of Contents >> Navigation: Monitoring Tools > checkurl > Usage |
Command Line Parameters
checkurl /auth <basic|digest|ntlm|kerberos> /u <USER> /p <PASS> /loginpage <loginurl> /loginformdata <form data for loginpage> /proxyhost <proxyserver> /proxyport <proxy port> /proxyuser <proxy username> /proxypass <password for proxyuser> /checksum /checksums_clear /t <TEXT> /lc /le /evt <OPTIONS> /certdays <DAYS> <URL>
/u MyUser |
Authenticate as user MyUser to web page |
/p "my pass" |
Use specified password for /u option |
|
|
/proxyhost |
Host name or IP address of proxy server |
/proxyport |
IP port of proxy server |
/proxyuser |
Username for proxy server (if required) |
/proxypass |
Password for <proxyuser> |
|
|
/loginpage <login page> |
URL of page to login in prior to contacting URL |
/loginformdata <form data> |
Form data for "loginpage" in key value pairs (e.g. user=admin,pass=secret) |
|
|
/checksum |
Create or compare checksum of page |
/checksums_clear |
Delete all cached checksums from the registry |
/t "text to look for" |
Search for specified text on page (not case sensitive) |
/certdays <days> |
Alert if certificate it expires in <days> or fewer days, requires https URL |
/certonly |
Only performs certificate check and ignores errors related to authentication, requires /certdays |
/f |
Follow HTTP redirect (302) responses |
/i |
Ignore non-trusted certificates |
/usewininet |
Use built-in Windows (Internet Explorer) HTTP-engine |
/lc |
Log all output to console |
/le |
Log all output to event log |
/evt "options" |
Rules for event log logging |
Examples
Example 1: Log an error to the event log when the page http://www.eventsentry.com/downloads/version-history changes:
checkurl /checksum /lc /le /evt "CHECKSUM_CHANGE=Error,CHECKSUM_EQUAL=Ignore" https://www.eventsentry.com/downloads/version-history
Example 2: Log a warning to the event log when the string "About Google" is not found in URL http://www.google.com and log results to the event log:
checkurl /t "About Google" /le /evt "TXT_FOUND=Information,TXT_NOTFOUND=Warning" https://www.google.com/
Example 3: Log a warning to the event log when the string "Island Life" is not found in URL https://www.dharmainitiative.com and log results to the event log. Log in first via URL "https://www.dharmainitiative.com/login" with accepts the form elements "username" and "password":
checkurl /loginpage https://www.dharmainitiative.com/login /loginformdata "username=john@locke.com,password=Iamlost" /t "Island Life" /le /evt "TXT_FOUND=Information,TXT_NOTFOUND=Warning" https://www.dharmainitiative.com/
Example 4: Connects to a HTTPS-enabled site to check a certificate, ignores any non-connection related errors such authentication
checkurl /certdays 60 /certonly https://myinternalsite.mycorp.com