Get-SqlDscAudit: Name no longer mandatory

CHANGELOG.md

@@ -22,6 +22,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Removed the regular expression `features?` from the GitVersion configuration.
     Before, if a fix commit mentioned the word feature but means a SQL Server
     feature GitVersion would bump minor instead of patch number.
+- `Get-SqlDscAudit`
+  - The parameter `Name` is no longer mandatory. When left out all the current
+    audits are returned ([issue #1812](https://github.com/dsccommunity/SqlServerDsc/issues/1812)).
 
 ### Fixed
 

source/Classes/020.SqlAudit.ps1

@@ -260,9 +260,12 @@ class SqlAudit : SqlResourceBase
 
         $serverObject = $this.GetServerObject()
 
-        $auditObject = $serverObject |
+        $auditObjectArray = $serverObject |
             Get-SqlDscAudit -Name $properties.Name -ErrorAction 'SilentlyContinue'
 
+        # Pick the only object in the array.
+        $auditObject = $auditObjectArray | Select-Object -First 1
+
         if ($auditObject)
         {
             $currentState.Name = $properties.Name
@@ -349,9 +352,12 @@ class SqlAudit : SqlResourceBase
             #>
             if ($this.Ensure -eq [Ensure]::Present)
             {
-                $auditObject = $serverObject |
+                $auditObjectArray = $serverObject |
                     Get-SqlDscAudit -Name $this.Name -ErrorAction 'Stop'
 
+                # Pick the only object in the array.
+                $auditObject = $auditObjectArray | Select-Object -First 1
+
                 if ($auditObject)
                 {
                     $auditIsWrongType = (

source/Public/Disable-SqlDscAudit.ps1

@@ -85,7 +85,10 @@ function Disable-SqlDscAudit
             }
 
             # If this command does not find the audit it will throw an exception.
-            $AuditObject = Get-SqlDscAudit @getSqlDscAuditParameters
+            $auditObjectArray = Get-SqlDscAudit @getSqlDscAuditParameters
+
+            # Pick the only object in the array.
+            $AuditObject = $auditObjectArray | Select-Object -First 1
         }
 
         $verboseDescriptionMessage = $script:localizedData.Audit_Disable_ShouldProcessVerboseDescription -f $AuditObject.Name, $AuditObject.Parent.InstanceName

source/Public/Enable-SqlDscAudit.ps1

@@ -85,7 +85,10 @@ function Enable-SqlDscAudit
             }
 
             # If this command does not find the audit it will throw an exception.
-            $AuditObject = Get-SqlDscAudit @getSqlDscAuditParameters
+            $auditObjectArray = Get-SqlDscAudit @getSqlDscAuditParameters
+
+            # Pick the only object in the array.
+            $AuditObject = $auditObjectArray | Select-Object -First 1
         }
 
         $verboseDescriptionMessage = $script:localizedData.Audit_Enable_ShouldProcessVerboseDescription -f $AuditObject.Name, $AuditObject.Parent.InstanceName

source/Public/Get-SqlDscAudit.ps1

@@ -29,16 +29,17 @@
 #>
 function Get-SqlDscAudit
 {
+    [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseOutputTypeCorrectly', '', Justification = 'Because the rule does not understands that the command returns [System.String[]] when using , (comma) in the return statement')]
     [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('UseSyntacticallyCorrectExamples', '', Justification = 'Because the rule does not yet support parsing the code when a parameter type is not available. The ScriptAnalyzer rule UseSyntacticallyCorrectExamples will always error in the editor due to https://github.com/indented-automation/Indented.ScriptAnalyzerRules/issues/8.')]
-    [OutputType([Microsoft.SqlServer.Management.Smo.Audit])]
+    [OutputType([Microsoft.SqlServer.Management.Smo.Audit[]])]
     [CmdletBinding()]
     param
     (
         [Parameter(Mandatory = $true, ValueFromPipeline = $true)]
         [Microsoft.SqlServer.Management.Smo.Server]
         $ServerObject,
 
-        [Parameter(Mandatory = $true)]
+        [Parameter()]
         [System.String]
         $Name,
 
@@ -55,22 +56,31 @@ function Get-SqlDscAudit
             $ServerObject.Audits.Refresh()
         }
 
-        $auditObject = $ServerObject.Audits[$Name]
+        $auditObject = @()
 
-        if (-not $AuditObject)
+        if ($PSBoundParameters.ContainsKey('Name'))
         {
-            $missingAuditMessage = $script:localizedData.Audit_Missing -f $Name
+            $auditObject = $ServerObject.Audits[$Name]
 
-            $writeErrorParameters = @{
-                Message = $missingAuditMessage
-                Category = 'InvalidOperation'
-                ErrorId = 'GSDA0001' # cspell: disable-line
-                TargetObject = $Name
-            }
+            if (-not $AuditObject)
+            {
+                $missingAuditMessage = $script:localizedData.Audit_Missing -f $Name
+
+                $writeErrorParameters = @{
+                    Message = $missingAuditMessage
+                    Category = 'InvalidOperation'
+                    ErrorId = 'GSDA0001' # cspell: disable-line
+                    TargetObject = $Name
+                }
 
-            Write-Error @writeErrorParameters
+                Write-Error @writeErrorParameters
+            }
+        }
+        else
+        {
+            $auditObject = $ServerObject.Audits
         }
 
-        return $auditObject
+        return , [Microsoft.SqlServer.Management.Smo.Audit[]] $auditObject
     }
 }

source/Public/New-SqlDscAudit.ps1

@@ -216,7 +216,7 @@ function New-SqlDscAudit
 
         $auditObject = Get-SqlDscAudit @getSqlDscAuditParameters
 
-        if ($auditObject)
+        if ($auditObject.Count -gt 0)
         {
             $auditAlreadyPresentMessage = $script:localizedData.Audit_AlreadyPresent -f $Name
 

source/Public/Remove-SqlDscAudit.ps1

@@ -85,7 +85,10 @@ function Remove-SqlDscAudit
             }
 
             # If this command does not find the audit it will throw an exception.
-            $AuditObject = Get-SqlDscAudit @getSqlDscAuditParameters
+            $auditObjectArray = Get-SqlDscAudit @getSqlDscAuditParameters
+
+            # Pick the only object in the array.
+            $AuditObject = $auditObjectArray | Select-Object -First 1
         }
 
         $verboseDescriptionMessage = $script:localizedData.Audit_Remove_ShouldProcessVerboseDescription -f $AuditObject.Name, $AuditObject.Parent.InstanceName

source/Public/Set-SqlDscAudit.ps1

@@ -259,7 +259,11 @@ function Set-SqlDscAudit
                 ErrorAction = 'Stop'
             }
 
-            $AuditObject = Get-SqlDscAudit @getSqlDscAuditParameters
+            # If this command does not find the audit it will throw an exception.
+            $auditObjectArray = Get-SqlDscAudit @getSqlDscAuditParameters
+
+            # Pick the only object in the array.
+            $AuditObject = $auditObjectArray | Select-Object -First 1
         }
 
         if ($Refresh.IsPresent)

tests/Unit/Public/Get-SqlDscAudit.Tests.ps1

@@ -53,7 +53,7 @@ Describe 'Get-SqlDscAudit' -Tag 'Public' {
     It 'Should have the correct parameters in parameter set <MockParameterSetName>' -ForEach @(
         @{
             MockParameterSetName = '__AllParameterSets'
-            MockExpectedParameters = '[-ServerObject] <Server> [-Name] <string> [-Refresh] [<CommonParameters>]'
+            MockExpectedParameters = '[-ServerObject] <Server> [[-Name] <string>] [-Refresh] [<CommonParameters>]'
         }
     ) {
         $result = (Get-Command -Name 'Get-SqlDscAudit').ParameterSets |
@@ -146,4 +146,42 @@ Describe 'Get-SqlDscAudit' -Tag 'Public' {
             }
         }
     }
+
+    Context 'When getting all current audits' {
+        BeforeAll {
+            $mockServerObject = New-Object -TypeName 'Microsoft.SqlServer.Management.Smo.Server'
+            $mockServerObject.InstanceName = 'TestInstance'
+
+            $mockServerObject = $mockServerObject |
+                Add-Member -MemberType 'ScriptProperty' -Name 'Audits' -Value {
+                    return @(
+                        (
+                            New-Object -TypeName 'Microsoft.SqlServer.Management.Smo.Audit' -ArgumentList @(
+                                $mockServerObject,
+                                'Log1'
+                            )
+                        ),
+                        (
+                            New-Object -TypeName 'Microsoft.SqlServer.Management.Smo.Audit' -ArgumentList @(
+                                $mockServerObject,
+                                'Log2'
+                            )
+                        )
+                    )
+                } -PassThru -Force
+
+            $mockDefaultParameters = @{
+                ServerObject = $mockServerObject
+            }
+        }
+
+        It 'Should return the correct values' {
+            $result = Get-SqlDscAudit @mockDefaultParameters
+
+            $result | Should -BeOfType 'Microsoft.SqlServer.Management.Smo.Audit'
+            $result | Should -HaveCount 2
+            $result.Name | Should -Contain 'Log1'
+            $result.Name | Should -Contain 'Log2'
+        }
+    }
 }