README.txt
|
OnCommand-Insight
================= OnCommand-Insight PowerShell Module Installation ------------ The recommended way to install the PowerShell Module is through the new Install-Module Cmdlet available in PowerShell 5. Consider installing PowerShell 5 from https://www.microsoft.com/en-us/download/details.aspx?id=50395. Then run ```powershell Install-Module OnCommand-Insight ``` The OnComamnd Insight PowerShell Cmdlets require at least PowerShell 3.0 and .NET 4.5. Microsoft has documented the required procedures to install PowerShell 3.0 in the article [Installing Windows PowerShell](https://technet.microsoft.com/de-de/library/hh847837.aspx?f=255&MSPPError=-2147217396). If you can't install via `Install-Module` you can download the latest version of OnCommand-Insight.zip from https://github.com/ffeldhaus/OnCommand-Insight/releases/latest. Then extract OnCommand-Insight.zip to your preferred PowerShell Module location (e.g. for current user to `$HOME\WindowsPowershell\Documents\WindowsPowerShell\Modules` or for all users to `C:\Windows\System32\WindowsPowerShell\v1.0\Modules`). Usage ----- Check if OnCommand-Insight Module can be found by PowerShell Get-Module -ListAvailable OnCommand-Insight Import PowerShell Module Import-Module OnCommand-Insight List all Cmdlets included in the OnCommand-Insight Module Get-Command -Module OnCommand-Insight Show help for Cmdlet to connect to OnCommand-Insight Server Get-Help Connect-OciServer -Detailed Connect to OnCommand Insight Server using the `-Insecure` Switch to skip checking the certificate of the server $Credential = Get-Credential Connect-OciServer -Name myserver.mydomain.tld -Credential $Credential -Insecure List all Storage Arrays Get-OciStorages Trusting the Publisher of the OnCommand Insight Cmdlets ------------------------------------------------------- This PowerShell Module is signed with a code signing certificate issued by the *NetApp Corp Issuing CA 1*. If the PowerShell execution policy requires powershell scripts to be signed (see [about_Execution_Policies](technet.microsoft.com/library/hh847748.aspx) for details), two steps are required to run this PowerShell Module 1. Trust the NetApp Root Certification Authority. This can be done with the following command executed in PowerShell `Start-Process powershell -Verb RunAs -ArgumentList '-nologo -command (New-Object System.Net.WebClient).DownloadFile(\"http://pki2.netapp.com/pki/NetApp%20Corp%20Root%20CA.crt\",\"$env:TEMP\netapp.crt\");certutil -addstore root $env:TEMP\netapp.crt;rm $env:TEMP\netapp.cr*;PAUSE'` or manually via the following steps: 1. download the NetApp Root CA certificate from (http://pki1.netapp.com/pki/NetApp%20Corp%20Root%20CA.crt) 2. double click on the downloaded file 3. click on *Install Certificate...* 4. click on *Next >* 5. Select *Place all certificates in the following store* 6. Click *Browse* 7. Select *Trusted Root Certification Authorities* 8. Click *OK* 9. Click *Next >* 10. Click Finish 11. A *Security Warning* will be displayed. Click *Yes* to install the certificate. The *Thumbprint (sha1)* should be **9FFB6F1A 06BC0245 27368705 2E7309D3 6FF2CFD0** 12. Click twice on *OK* to close the dialogs. 2. When importing the PowerShell module via `Import-Module OnCommand-Insigh` a dialog is displayed asking if the publisher *CN=florianf-Florian-Feldhaus, OU=Users, OU=EMEA, OU=Sites, DC=hq, DC=netapp, DC=com* should be trusted. Select *[A] Always run* to permanently trust this publisher. Attribution ----------- Windows Credential Manager functionality based on [PowerShell Credentials Manager](https://gallery.technet.microsoft.com/scriptcenter/PowerShell-Credentials-d44c3cde) is included in this module. Changelog --------- ### Version 1.0.0 - First release - Proper authentication handling - Included example for storage array performance history export to Excel. - Created proper PowerShell Module. Fixed pipeline support. Added Search-Oci Cmdlet. ### Version 1.1.0 - Fixed naming of Cmdlets and fixed several issues. Most Cmdlets are tested and should work. - Lots of minor bug fixes. Improved Module generation. Added lots of examples. ### Version 1.2.0 - Release 1.2.0 Lots of bug fixes. Improved Performance retrieval and annotation setting / updating. ### Version 1.3.0 Added OCI Server health status retrieval. ### Version 1.4.0 Added Excel export functionality and examples in tutorial. ### Version 1.4.1 Fixed some issues with Excel functionality ### Version 1.5.0 Added adding and retrieving credentials from the Windows Credential Manager |