New Get-ITGlueLogs & Added support for the Australian datacenter

ITGlueAPI/ITGlueAPI.psd1

@@ -18,7 +18,7 @@
     # -- MINOR version when you add functionality in a backwards-compatible manner, and
     # -- PATCH version when you make backwards-compatible bug fixes.
 
-    ModuleVersion = '2.1.0'
+    ModuleVersion = '2.2.0'
 
     # ID used to uniquely identify this module
     GUID = 'f969cff1-3120-4980-8c46-83f2d0bf2521'
@@ -88,6 +88,7 @@
                     'Resources/FlexibleAssetTypes.ps1',
                     'Resources/Groups.ps1',
                     'Resources/Locations.ps1',
+                    'Resources/Logs.ps1',
                     'Resources/Manufacturers.ps1',
                     'Resources/Models.ps1',
                     'Resources/OperatingSystems.ps1',
@@ -149,7 +150,7 @@
                         'Set-ITGlueDocuments',
 
                         'Get-ITGlueDomains',
-                        
+
                         'Get-ITGlueExpirations',
 
                         'New-ITGlueFlexibleAssetFields',
@@ -173,6 +174,8 @@
                         'Set-ITGlueLocations',
                         'Remove-ITGlueLocations',
 
+                        'Get-ITGlueLogs',
+
                         'New-ITGlueManufacturers',
                         'Get-ITGlueManufacturers',
                         'Set-ITGlueManufacturers',

ITGlueAPI/ITGlueAPI.psm1

@@ -1,5 +1,5 @@
-$ITGlue_Headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"   
-$ITGlue_Headers.Add("Content-Type", 'application/vnd.api+json') 
+$ITGlue_Headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
+$ITGlue_Headers.Add("Content-Type", 'application/vnd.api+json')
 
 Set-Variable -Name "ITGlue_Headers"  -Value $ITGlue_Headers -Scope global
 

ITGlueAPI/Internal/BaseURI.ps1

@@ -5,26 +5,27 @@ function Add-ITGlueBaseURI {
         [string]$base_uri = 'https://api.itglue.com',
 
         [Alias('locale','dc')]
-        [ValidateSet( 'US', 'EU')]
+        [ValidateSet( 'US', 'EU', 'AU')]
         [String]$data_center = ''
     )
 
-    # Trim superflous forward slash from address (if applicable)
+    # Trim superfluous forward slash from address (if applicable)
     if($base_uri[$base_uri.Length-1] -eq "/") {
         $base_uri = $base_uri.Substring(0,$base_uri.Length-1)
     }
 
     switch ($data_center) {
         'US' {$base_uri = 'https://api.itglue.com'}
         'EU' {$base_uri = 'https://api.eu.itglue.com'}
+        'AU' {$base_uri = 'https://api.au.itglue.com'}
         Default {}
     }
 
     Set-Variable -Name "ITGlue_Base_URI" -Value $base_uri -Option ReadOnly -Scope global -Force
 }
 
 function Remove-ITGlueBaseURI {
-    Remove-Variable -Name "ITGlue_Base_URI" -Scope global -Force 
+    Remove-Variable -Name "ITGlue_Base_URI" -Scope global -Force
 }
 
 function Get-ITGlueBaseURI {

ITGlueAPI/Internal/ModuleSettings.ps1

@@ -27,7 +27,7 @@ function Import-ITGlueModuleSettings {
     if(test-path ($ITGlueAPIConfPath+"\"+$ITGlueAPIConfFile) )  {
         $tmp_config = Import-LocalizedData -BaseDirectory $ITGlueAPIConfPath -FileName $ITGlueAPIConfFile
 
-        # Send to function to strip potentially superflous slash (/)
+        # Send to function to strip potentially superfluous slash (/)
         Add-ITGlueBaseURI $tmp_config.ITGlue_Base_URI
 
         $tmp_config.ITGlue_API_key = ConvertTo-SecureString $tmp_config.ITGlue_API_key
@@ -36,7 +36,7 @@ function Import-ITGlueModuleSettings {
                     -Option ReadOnly -Scope global -Force
 
         Set-Variable -Name "ITGlue_JSON_Conversion_Depth" -Value $tmp_config.ITGlue_JSON_Conversion_Depth `
-                    -Scope global -Force 
+                    -Scope global -Force
 
         Write-Host "ITGlueAPI Module configuration loaded successfully from $ITGlueAPIConfPath\$ITGlueAPIConfFile!" -ForegroundColor Green
 
@@ -45,12 +45,12 @@ function Import-ITGlueModuleSettings {
     }
     else {
         Write-Host "No configuration file was found at $ITGlueAPIConfPath\$ITGlueAPIConfFile." -ForegroundColor Red
-        
+
         Set-Variable -Name "ITGlue_Base_URI" -Value "https://api.itglue.com" -Option ReadOnly -Scope global -Force
-        
+
         Write-Host "Using https://api.itglue.com as Base URI. Run Add-ITGlueBaseURI to modify."
         Write-Host "Please run Add-ITGlueAPIKey to get started." -ForegroundColor Red
-        
+
         Set-Variable -Name "ITGlue_JSON_Conversion_Depth" -Value 100 -Scope global -Force
     }
 }

ITGlueAPI/Resources/Attachments.ps1

@@ -1,7 +1,7 @@
 function New-ITGlueAttachments {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -32,14 +32,14 @@ function New-ITGlueAttachments {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }
 
 function Set-ITGlueAttachments {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -74,14 +74,14 @@ function Set-ITGlueAttachments {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }
 
 function Remove-ITGlueAttachments {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -112,6 +112,6 @@ function Remove-ITGlueAttachments {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }

ITGlueAPI/Resources/Documents.ps1

@@ -36,6 +36,6 @@ function Set-ITGlueDocuments {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }

ITGlueAPI/Resources/Expirations.ps1

@@ -22,7 +22,7 @@ function Get-ITGlueExpirations {
 
         [Parameter(ParameterSetName = 'index')]
         [String]$filter_expiration_date = '',
-        
+
         [Parameter(ParameterSetName = 'index')]
         [Int64]$filter_organization_id = '',
 

ITGlueAPI/Resources/Logs.ps1

@@ -0,0 +1,42 @@
+function Get-ITGlueLogs {
+    [CmdletBinding(DefaultParameterSetName = 'index')]
+    Param (
+        [Parameter(ParameterSetName = 'index')]
+        [ValidateSet( 'created_at', 'updated_at', '-created_at', '-updated_at' )]
+        [String]$sort = '',
+
+        [Parameter(ParameterSetName = 'index')]
+        [Nullable[Int64]]$page_number = $null,
+
+        [Parameter(ParameterSetName = 'index')]
+        [Nullable[int]]$page_size = $null
+    )
+
+    $resource_uri = '/logs'
+
+    if ($PSCmdlet.ParameterSetName -eq 'index') {
+        if ($sort) {
+            $body += @{'sort' = $sort}
+        }
+        if ($page_number) {
+            $body += @{'page[number]' = $page_number}
+        }
+        if ($page_size) {
+            $body += @{'page[size]' = $page_size}
+        }
+    }
+
+    try {
+        $ITGlue_Headers.Add('x-api-key', (New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList 'N/A', $ITGlue_API_Key).GetNetworkCredential().Password)
+        $rest_output = Invoke-RestMethod -method 'GET' -uri ($ITGlue_Base_URI + $resource_uri) -headers $ITGlue_Headers `
+            -body $body -ErrorAction Stop -ErrorVariable $web_error
+    } catch {
+        Write-Error $_
+    } finally {
+        [void] ($ITGlue_Headers.Remove('x-api-key')) # Quietly clean up scope so the API key doesn't persist
+    }
+
+    $data = @{}
+    $data = $rest_output
+    return $data
+}

ITGlueAPI/Resources/Organizations.ps1

@@ -50,7 +50,7 @@ function Get-ITGlueOrganizations {
 
         [Parameter(ParameterSetName = 'index')]
         [Nullable[Int64]]$filter_my_glue_account_id = $null,
-        
+
         [Parameter(ParameterSetName = 'index')]
         [Nullable[Int64]]$filter_group_id = $null,
 

ITGlueAPI/Resources/RelatedItems.ps1

@@ -1,7 +1,7 @@
 function New-ITGlueRelatedItems {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -32,14 +32,14 @@ function New-ITGlueRelatedItems {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }
 
 function Set-ITGlueRelatedItems {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -74,14 +74,14 @@ function Set-ITGlueRelatedItems {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }
 
 function Remove-ITGlueRelatedItems {
     [CmdletBinding()]
     Param (
-        [Parameter(Mandatory = $true)]    
+        [Parameter(Mandatory = $true)]
         [ValidateSet( 'checklists', 'checklist_templates', 'configurations', 'contacts', 'documents', `
                 'domains', 'locations', 'passwords', 'ssl_certificates', 'flexible_assets', 'tickets')]
         [string]$resource_type,
@@ -112,6 +112,6 @@ function Remove-ITGlueRelatedItems {
     }
 
     $data = @{}
-    $data = $rest_output 
+    $data = $rest_output
     return $data
 }

ITGlueAPI/Tests/BaseURI.Tests.ps1

@@ -6,21 +6,26 @@ $ThisFileName = $ThisFile | Split-Path -Leaf
 
 Describe "Tests" {
     Context "Test $ThisFileName Functions" {
-        It "Add-ITGlueBaseURI without parameter should reutrn a valid URI" {
+        It "Add-ITGlueBaseURI without parameter should return a valid URI" {
             Add-ITGlueBaseURI
             $BaseURI = Get-ITGlueBaseURI
             $BaseURI | Should -Be 'https://api.itglue.com'
         }
-        It "Add-ITGlueBaseURI parameter US should reutrn a valid URI" {
+        It "Add-ITGlueBaseURI parameter US should return a valid URI" {
             Add-ITGlueBaseURI -data_center 'US'
             $BaseURI = Get-ITGlueBaseURI
             $BaseURI | Should -Be 'https://api.itglue.com'
         }
-        It "Add-ITGlueBaseURI parameter EU should reutrn a valid URI" {
+        It "Add-ITGlueBaseURI parameter EU should return a valid URI" {
             Add-ITGlueBaseURI -data_center 'EU'
             $BaseURI = Get-ITGlueBaseURI
             $BaseURI | Should -Be 'https://api.eu.itglue.com'
         }
+        It "Add-ITGlueBaseURI parameter AU should return a valid URI" {
+            Add-ITGlueBaseURI -data_center 'AU'
+            $BaseURI = Get-ITGlueBaseURI
+            $BaseURI | Should -Be 'https://api.au.itglue.com'
+        }
         It "Remove-ITGlueBaseURI should remove the variable" {
             Remove-ITGlueBaseURI
             $BaseURI = Get-ITGlueBaseURI

ITGlueAPI/Tests/ITGlueAPI.Tests.ps1

@@ -42,6 +42,7 @@ $ResourceDirectoryFiles = (
     'FlexibleAssetTypes.ps1',
     'Groups.ps1',
     'Locations.ps1',
+    'Logs.ps1',
     'Manufacturers.ps1',
     'Models.ps1',
     'OperatingSystems.ps1',
@@ -137,10 +138,10 @@ Describe "Module Tests" {
         }
         # TODO - add tests to check for tests files
     }
-    
+
     Context "PowerShell $ThisModuleName Import Test" {
         # Credit - borrowed with care from https://github.com/TheMattCollins0/MattTools/blob/master/Tests/ModuleImport.Tests.ps1 and modified as needed
-        It "Should import PowerShell $ThisModuleName succesfully" {
+        It "Should import PowerShell $ThisModuleName successfully" {
             Import-Module -Name $ThisModulePath -ErrorVariable ImportError
             $ImportError | Should Be $null
         }