Searching IIS logs with Search-IISWebsiteLog

Today I'd like to talk about the Search-IISSiteLog cmdlet that's part of the CPolydorou.IIS module. This cmdlet can be used in order to search text base log files, especially IIS website logs.

Let's dive right in and search the Exchange IIS logs for the requests of a specific user!

We'll start by getting the sites on an Exchange 2013 server:

PS C:\> Get-Website

Name             ID State   Physical Path
----             -- -----   -------------
Default Web Site 1  Started %SystemDrive%\inetpub\wwwroot
Exchange Back En 2  Started C:\inetpub\wwwroot

Since we want to search for a user's requests, we'll use the "Default Web Site" website. Our exchange servers are named "exchange2013a" and "exchange2013b".

The Search-IISSiteLog command would be:

Search-IISSiteLog -WebSite "Default Web Site" `
                  -Pattern "cpolydorou" `
                  -ComputerName "exchange2013a","exchange2013b"

This command will get the path to the log files for the "Default Web Site" website on the specified servers and then will search the files for the pattern "cpolydorou" which corresponds to our user.

The key here is that the process will be executed in parallel and each server will take it's share of the load.

The output of the command will be objects like the following:

ComputerName          : EXCHANGE2013A
File                  : u_ex180120_x.log
Entry                 : 2018-01-20 19:11:13 ... POST /ecp/ 443 cpolydorou@lab.local ...
PSComputerName        : localhost
RunspaceId            : c88d0754-4a35-4cd9-a8f0-9b392bc82b41
PSSourceJobInstanceId : 0e1b09e8-b015-4618-baf4-b29f472182bd

Each object represents a line in a log file that matches the pattern. It contains the name of the server, the name of the file in order for us to be able to locate it and the entry itself.

The above command will search all the files in the log folder, which is not necessarily good since it may take some time and computing power that is not needed. In case we have a time frame for the requests we need to search, we can use the "-Start" and "-End" parameters.

When those parameters are used, the files in the log folders are filtered based on their LastWriteTime property and any files that have not been updated in that period are not searched.

The caveat here is that the timestamp of the requests is usually on GTM format and the LastWriteTime on the files on the time of the server! I would suggest widening the period of time for the search in order to search fewer files and then search the entries using their timestamp.

Although this workflow is created to search IIS website log files, it can be used to search any kind of text file in a directory. Use the "-Path" parameter to specify the directory containing the log files and you're all set.

The CPolydorou.IIS module is available on the PowerShell Gallery, I hope you'll find it helpful!

Popular posts from this blog

Domain Controller Machine Password Reset

Image
On my lab environment, I've configured two Active Directory sites since most enterprises have offices in more that one places. My lab however is not running 24/7 and the domain controllers in the second site are rarely turned on in order to save resources. This leads to issues with the Active Directory replication such as the "The target principal name is incorrect" error when I execute:  repadmin /syncall /AdeP. To remedy the issue, we have to reset the machine password of the domain controller that has been offline. First off, we are going to stop and disable the Kerberos Key Distribution Center (kdc) service on the problematic domain controller, in our case DC4. There may be some tickets in the cache so we should also clear them using klist purge Now it's time to change the machine password of the domain controller using the command netdom resetpwd /s:dc3 /ud:lab\administrator /pd:* Replace the "lab\administrator" with an account on your...
Keep reading

Managing Active Directory User Certificates using PowerShell

I first came across user certificates when I was working with email certificates a few years ago and I have to admit that I had trouble updating the certificates on the objects! Most organizations have a Microsoft Active Directory Certification Authority that issues the certificates used internally. When a certificate is issued to a user, the Microsoft Certificate Service saves the public key in Active Directory. The userCertificate attribute is a multi-valued attribute that contains the DER-encoded X509v3 certificates issued to the user. Although we rarely need to pay attention to this attribute, there are cases where we have to update it. To make things easier, I've written PowerShell functions to Get, Remove, Import and Export the certificates on that field. To get the list of certificates for an object, use the Get-ActiveDirectoryObjectCertificate function: PS C:\> Get-ActiveDirectoryObjectCertificate -UserPrincipalName cpolydorou@lab.local DistinguishedName  ...
Keep reading

Configuring a Certificate on Exchange Receive Connector

Today's article is about configuring Exchange receive connectors with specific certificates. Out of the box, Exchange uses self signed certificates to provide TLS secured mail flow. This will definitely be an issue if you expose the SMTP protocol to client computers since they won't trust the certificate. In this article we are going to configure a certificate that was issued by a third part authority to the Client Frontend receive connector. We'll start with getting the thumbprint of the certificate using the Get-ExchangeCertificate cmdlet: [PS] C:\> Get-ExchangeCertificate Thumbprint                               Subject ----------                               ------- 241B864DC82C664FECBA18B8D54987AAFB65B4C2 CN=*.lab.com, ... D4D210886B34E690191A1F008C78FDD0E7325DD4 CN=Exchange2013A 960171662EB26116...
Keep reading