Usage

<< 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