Are there instructions on how to use this thing?
Thank you for posting in PI Square.
There is documentation and tutorials related to PI Security Audit Tools in the following wiki: Home · osisoft/PI-Security-Audit-Tools Wiki · GitHub . In the right side of the provided wiki you will find the mentioned tutorials.
Tutorial0: Run an audit (USERS) · osisoft/PI-Security-Audit-Tools Wiki · GitHub
Tutorial1: Add a validation check (CONTRIBUTORS) · osisoft/PI-Security-Audit-Tools Wiki · GitHub
Tutorial2: Running the scripts remotely (USERS) · osisoft/PI-Security-Audit-Tools Wiki · GitHub
Tutorial3: Using the PI Coresight Kerberos Configuration utility · osisoft/PI-Security-Audit-Tools Wiki · GitHub
You can also post questions about usage of the tools in the following PI Square thread: Check out the PI Security Audit Tools on GitHub
This looks like a bunch of wonkish gibberish, for the most part. However, this was the output that I got. I have no idea what it means, other than it probably didn't work. Definitely not very user friendly
I agree that any PowerShell tool can be tricky to use and in particular to debug when things does go wrong.
I contacted the developers to see if they can add a particular reference that would be helpful guide to the various PowerShell commands used in the application.
Until a good reference is added, you can consider reading up on: Windows PowerShell Tip: Referencing Variables and Variable Values if you wanted to learn more regarding how variables are used in PowerShell.
Regarding the particular error you faced, I am wondering if it could be due to difficulty accessing a particular PI Data Archive.
In step 7, in the command: $cpt = piauditparams $null "piomnibox" "pidataarchive" is the word piomnibox replaced by a PI Data Archive you can connect to?
For example, if I run this command locally on the PI Data Archive, I can use localhost to refer to host name of my PI Data Archive and I can use the following way to define the cpt variable:
$cpt = piauditparams $null "localhost" "pidataarchive"
Hi Mark, what is the $cpt variable set to?
To add more resources on PI Security Audit Tools, here is a relevant webinar:
PI Developers Club Webinar Series: Introducing the PI Security Audit Tools
And attached to this post is a workbook from the relevant OSIsoft UC 2017 lab.
This error means that the ComputerParametersTable (-cpt) variable was an array of objects (Object) when the New-PISysAuditReport (piaudit) command expects it to be a hashtable. If the $cpt variable is set by calling the piauditparams command as indicated by Jerome Lefebvre then it should be in the expected form of a hashtable, so I'm also interested in the actual value of $cpt when you see this error and how it was set.
If you give the exact commands you ran to set the value of $cpt, then I should be able to reproduce the issue and potentially come up with a more user friendly way to handle it in the scripts or figure out where the documentation is unclear.
Thanks for the responses. We got it to work today, but we needed to use the 'Set-ExecutionPolicy Unrestricted' before we could run anything. I'll look at some more stuff to figure out how to do the AF server
Retrieving data ...