Initial commit

Author: ffeldhaus

.gitignore

@@ -0,0 +1,2 @@
+*.psd1
+release/

OnCommand-Insight-Tutorial.md

@@ -0,0 +1,80 @@
+# OnCommand Insight (OCI) PowerShell Cmdlet Tutorial
+
+This tutorial will give an introduction to the OnCommand Insight PowerShell Cmdlets
+
+## Discovering the available Cmdlets
+
+Load the OCI Module
+
+```powershell
+Import-Module OnCommand-Insight
+```
+
+Show all available Cmdlets from the OCI Module
+
+```powershell
+Get-Command -Module OnCommand-Insight
+```
+
+Show the syntax of all Cmdlets from the OCI Module
+
+```powershell
+Get-Command -Module OnCommand-Insight
+```
+
+To get detailed help including examples for a specific Cmdlet (e.g. for Connect-OciServer) run
+
+```powershell
+Get-Help Connect-OciServer -Detailed
+```
+
+## Connecting to an OCI Server
+
+For data retrieval a connection to the OCI Server is required. The Connect-OciServer Cmdlet expects the hostname or IP and the credentials for authentication
+
+```powershell
+$ServerName = 'ociserver.example.com'
+$Credential = Get-Credential
+Connect-OciServer -Name $ServerName -Credential $Credential
+```
+
+If the login fails, it is often due to an untrusted certificate of the OCI Server. You can ignore the certificate check with the `-insecure` option
+
+```powershell
+Connect-OciServer -Name $ServerName -Credential $Credential -Insecure
+```
+
+By default the connection to the OCI server is established through HTTPS. If that doesn't work, HTTP will be tried. 
+
+To force connections via HTTPS use the `-HTTPS` switch
+
+```powershell
+Connect-OciServer -Name $ServerName -Credential $Credential -HTTPS
+```
+
+To force connections via HTTP use the `-HTTP` switch
+
+```powershell
+Connect-OciServer -Name $ServerName -Credential $Credential -HTTP
+```
+    
+As the Timezone of the OCI Server is not available via the REST API, it needs to be manually set. By default the Timezone will be set to the local timezone of the PowerShell environment.
+
+The currently configured timezone of the OCI Server can be checked with
+
+```powershell
+$CurrentOciServer.Timezone
+```
+    
+A list of all available timezones can be shown with
+
+```powershell
+[System.TimeZoneInfo]::GetSystemTimeZones()
+```
+
+To set a different timezone (e.g. CEST or PST), the following command can be used
+
+```powershell
+$CurrentOciServer.Timezone = [System.TimeZoneInfo]::FindSystemTimeZoneById("Central Europe Standard Time")
+$CurrentOciServer.Timezone = [System.TimeZoneInfo]::FindSystemTimeZoneById("Pacific Standard Time")
+```

README.md

@@ -0,0 +1,79 @@
+OnCommand-Insight
+=================
+
+OnCommand-Insight PowerShell Module
+
+Installation
+------------
+
+Extract OnCommand-Insight.zip either to your preferred PowerShell Module location (e.g. `$HOME\WindowsPowershell\Documents\WindowsPowerShell\Modules` or `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-OciStorageArrays
+
+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. downloading 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.
+
+	
+Changelog
+---------
+
+### Version 0.3
+
+* Module is now signed
+* added instructions to trust the publisher of the Module
+* added ability for most cmdlets to accept pipeline input
+* streamlined usage of the parameter ID. All cmdlets accepting ID parameters now have named parameters like VolumeID or HostID and ID is an alias to these parameters (e.g. ID always works).
+* added formatting of OCI types
+
+### Version 0.2
+
+* improved Help and added Parameter Help
+* solved Namespace issues when changing server and introduced OCI namespace
+* improved build process
+
+### Version 0.1
+
+* First internal release with all Cmdlets implemented

src/S3-Mgmt-examples.ps1

@@ -0,0 +1,23 @@
+Import-Module ./S3-Mgmt.ps1
+
+# Retrieve administrator credentials for StorageGRID NMS
+$Credential = Get-Credential
+
+# Connect to StorageGRID NMS
+Connect-S3Mgmt -Name cbc-sg-adm1.muccbc.hq.netapp.com -Credential $credential -Insecure
+
+# retrieve all S3 Accounts
+Get-S3Accounts
+
+# retrieve usage of each S3 Account
+Get-S3Accounts | Get-S3AccountUsage
+
+# create CSV Output S3 Account usage
+
+$Accounting = foreach ($Account in Get-S3Accounts) {
+    $Usage = Get-S3AccountUsage -id $Account.id
+    $Output = New-Object -TypeName PSCustomObject -Property @{Name=$Account.name;ID=$Account.id;"Calculation Time"=$Usage.calculationTime;"Object Count"=$Usage.objectCount;"Data Bytes used"=$Usage.dataBytes}
+    Write-Output $Output
+} 
+
+Export-Csv -Path C:\tmp\usage.csv -NoTypeInformation -InputObject $Accounting