Merge branch 'release/1.4.0'

abbgrade · abbgrade · commit 5490ffad7163 · 2025-12-17T09:04:54.000+01:00
diff --git a/.github/workflows/build-validation.yml b/.github/workflows/build-validation.yml
@@ -6,4 +6,4 @@ on:
 
 jobs:
   build-validation:
-    uses: abbgrade/PsBuildTasks/.github/workflows/build-validation-matrix.yml@1.11.0
+    uses: abbgrade/PsBuildTasks/.github/workflows/build-validation-matrix.yml@1.11.1
diff --git a/.github/workflows/pre-release.yml b/.github/workflows/pre-release.yml
@@ -1,11 +1,11 @@
 on:
   push:
-    branches: [ release/* ]
+    branches: [ release/*, 'hotfix/*' ]
   workflow_dispatch:
 
 jobs:
   pre-release:
-    uses: abbgrade/PsBuildTasks/.github/workflows/pre-release-windows.yml@1.11.0
+    uses: abbgrade/PsBuildTasks/.github/workflows/pre-release-windows.yml@1.11.1
     with:
       module-name: PsSmo
     secrets:
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -5,7 +5,7 @@ on:
 
 jobs:
   release:
-    uses: abbgrade/PsBuildTasks/.github/workflows/release-windows.yml@1.11.0
+    uses: abbgrade/PsBuildTasks/.github/workflows/release-windows.yml@1.11.1
     with:
       module-name: PsSmo
     secrets:
diff --git a/.gitignore b/.gitignore
@@ -4,3 +4,4 @@ obj
 coverage.xml
 testResults.xml
 */*/.vs
+.vs
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,13 +7,27 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.4.0] - 2025-12-11
+
+### Changed
+
+- Updated System.Management.Automation and PowerShellVersion to 7.4.
+- Updated TargetFramework to net8.0.
+- Updated Microsoft.SqlServer.SqlManagementObjects to 180.10.0.
+- Updated Microsoft.Data.SqlClient to 5.2.3.
+- Updated Azure.Identity to 1.13.0.
+
+### Added
+
+- Added command `Get-Schema`
+
 ## [1.3.0] - 2023-11-27
 
 ### Changed
 
 - Updated Microsoft.SqlServer.SqlManagementObjects to 170.18.0.
 - Updated System.Management.Automation to 7.2.16 and PowerShell 7.2.16.
-- Updated Microsoft.Data.SqlClient to 5.1.1.
+- Updated Microsoft.Data.SqlClient to 5.1.3.
 
 ## [1.2.1] - 2023-09-05
 
diff --git a/Readme.md b/Readme.md
@@ -1,6 +1,6 @@
 # PsSmo
 
-The PowerShell SQL Client module replaces the SQL Server utilities [SQLCMD](https://docs.microsoft.com/de-de/sql/tools/sqlcmd-utility) with native PowerShell commands.
+The PowerShell SQL Client module replaces the SQL Server utilities [SQLCMD](https://docs.microsoft.com/de-de/sql/tools/sqlcmd-utility) with native PowerShell commands. It is part of [PsSqlUtils](https://github.com/abbgrade/PsSqlUtils).
 
 ## Installation
 
diff --git a/docs/Connect-SmoInstance.md b/docs/Connect-SmoInstance.md
@@ -15,23 +15,26 @@ schema: 2.0.0
 ### Properties_IntegratedSecurity (Default)
 ```
 Connect-SmoInstance [-DataSource] <String> [[-InitialCatalog] <String>] [-AccessToken <String>]
- [-StatementTimeout <Int32>] [<CommonParameters>]
+ [-StatementTimeout <Int32>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### SqlClient
 ```
-Connect-SmoInstance -Connection <SqlConnection> [-StatementTimeout <Int32>] [<CommonParameters>]
+Connect-SmoInstance -Connection <SqlConnection> [-StatementTimeout <Int32>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### ConnectionString
 ```
-Connect-SmoInstance [-ConnectionString] <String> [-StatementTimeout <Int32>] [<CommonParameters>]
+Connect-SmoInstance [-ConnectionString] <String> [-StatementTimeout <Int32>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### Properties_Credential
 ```
 Connect-SmoInstance [-DataSource] <String> [[-InitialCatalog] <String>] [-UserId] <String>
- [-Password] <SecureString> [-StatementTimeout <Int32>] [<CommonParameters>]
+ [-Password] <SecureString> [-StatementTimeout <Int32>] [-ProgressAction <ActionPreference>]
+ [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -138,6 +141,21 @@ Accept pipeline input: True (ByPropertyName, ByValue)
 Accept wildcard characters: False
 ```
 
+### -StatementTimeout
+This is the number of seconds that a statement is attempted to be sent to the server before it fails.
+
+```yaml
+Type: Int32
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -UserId
 {{ Fill UserId Description }}
 
@@ -153,13 +171,13 @@ Accept pipeline input: True (ByPropertyName, ByValue)
 Accept wildcard characters: False
 ```
 
-### -StatementTimeout
-This is the number of seconds that a statement is attempted to be sent to the server before it fails.
+### -ProgressAction
+{{ Fill ProgressAction Description }}
 
 ```yaml
-Type: Int32
+Type: ActionPreference
 Parameter Sets: (All)
-Aliases:
+Aliases: proga
 
 Required: False
 Position: Named
diff --git a/docs/Disconnect-SmoInstance.md b/docs/Disconnect-SmoInstance.md
@@ -13,7 +13,7 @@ schema: 2.0.0
 ## SYNTAX
 
 ```
-Disconnect-SmoInstance [[-Instance] <Server>] [<CommonParameters>]
+Disconnect-SmoInstance [[-Instance] <Server>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -45,6 +45,21 @@ Accept pipeline input: True (ByValue)
 Accept wildcard characters: False
 ```
 
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
diff --git a/docs/Get-SmoTable.md b/docs/Get-SmoTable.md
@@ -13,7 +13,7 @@ schema: 2.0.0
 ## SYNTAX
 
 ```
-Get-SmoTable [-Name <String>] [-Instance <Server>] [<CommonParameters>]
+Get-SmoTable [-Name <String>] [-Instance <Server>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -60,6 +60,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
diff --git a/docs/Invoke-SmoCommand.md b/docs/Invoke-SmoCommand.md
@@ -14,12 +14,14 @@ schema: 2.0.0
 
 ### Text
 ```
-Invoke-SmoCommand -Text <String> [-Variables <Hashtable>] [-Instance <Server>] [<CommonParameters>]
+Invoke-SmoCommand -Text <String> [-Variables <Hashtable>] [-Instance <Server>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ### File
 ```
-Invoke-SmoCommand -InputFile <FileInfo> [-Variables <Hashtable>] [-Instance <Server>] [<CommonParameters>]
+Invoke-SmoCommand -InputFile <FileInfo> [-Variables <Hashtable>] [-Instance <Server>]
+ [-ProgressAction <ActionPreference>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
@@ -96,6 +98,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -ProgressAction
+{{ Fill ProgressAction Description }}
+
+```yaml
+Type: ActionPreference
+Parameter Sets: (All)
+Aliases: proga
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### CommonParameters
 This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
 
diff --git a/src/PsSmo/DisconnectInstanceCommand.cs b/src/PsSmo/DisconnectInstanceCommand.cs
@@ -15,7 +15,7 @@ public class DisconnectInstanceCommand : ClientCommand
         )]
         [ValidateNotNullOrEmpty()]
         [Alias("Connection")]
-        public Server Instance { get; set; } = ConnectInstanceCommand.Instance;
+        new public Server Instance { get; set; } = ConnectInstanceCommand.Instance;
 
         protected override void ProcessRecord()
         {
diff --git a/src/PsSmo/GetSchemaCommand.cs b/src/PsSmo/GetSchemaCommand.cs
@@ -0,0 +1,26 @@
+﻿using System.Management.Automation;
+using System.Linq;
+using Microsoft.SqlServer.Management.Smo;
+using System.Collections.Generic;
+
+namespace PsSmo
+{
+    [Cmdlet(VerbsCommon.Get, "Schema")]
+    [OutputType(typeof(Schema))]
+    public class GetSchemaCommand : ClientCommand
+    {
+        [Parameter()]
+        public string Name { get; set; }
+
+        protected override void ProcessRecord()
+        {
+            base.ProcessRecord();
+
+            foreach (Schema schema in Instance.Databases[Instance.ConnectionContext.CurrentDatabase].Schemas)
+            {
+                if (string.IsNullOrEmpty(Name) || schema.Name == Name)
+                    WriteObject(schema);
+            }
+        }
+    }
+}
diff --git a/src/PsSmo/PsSmo.csproj b/src/PsSmo/PsSmo.csproj
@@ -1,15 +1,16 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net6.0</TargetFramework>
+    <TargetFramework>net8.0</TargetFramework>
     <AssemblyName>PsSmo</AssemblyName>
   </PropertyGroup>
 
   <ItemGroup>
+    <PackageReference Include="Azure.Identity" Version="1.13.0" />
     <PackageReference Include="Microsoft.Azure.Services.AppAuthentication" Version="1.6.2" />
-    <PackageReference Include="Microsoft.SqlServer.SqlManagementObjects" Version="170.18.0" />
-    <PackageReference Include="System.Management.Automation" Version="7.2.16" />
-    <PackageReference Include="Microsoft.Data.SqlClient" Version="5.1.1" />
+    <PackageReference Include="Microsoft.Data.SqlClient" Version="5.2.3" />
+    <PackageReference Include="Microsoft.SqlServer.SqlManagementObjects" Version="180.10.0" />
+    <PackageReference Include="System.Management.Automation" Version="7.4.0" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/PsSmo/PsSmo.psd1 b/src/PsSmo/PsSmo.psd1
@@ -12,7 +12,7 @@
 RootModule = 'PsSmo.dll'
 
 # Version number of this module.
-ModuleVersion = '1.3.0'
+ModuleVersion = '1.4.0'
 
 # Supported PSEditions
 # CompatiblePSEditions = @()
@@ -33,7 +33,7 @@ Copyright = '(c) 2021 Steffen Kampmann. Alle Rechte vorbehalten.'
 Description = 'The PowerShell SQL Client module replaces the SQL Server utilities SQLCMD with native PowerShell commands.'
 
 # Minimum version of the PowerShell engine required by this module
-PowerShellVersion = '7.2.16'
+PowerShellVersion = '7.4'
 
 # Name of the PowerShell host required by this module
 # PowerShellHostName = ''
@@ -72,8 +72,13 @@ PowerShellVersion = '7.2.16'
 FunctionsToExport = '*'
 
 # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
-CmdletsToExport = 'Connect-Instance', 'Disconnect-Instance', 'Get-Table',
-               'Invoke-Command'
+CmdletsToExport = @(
+    'Invoke-Command',
+    'Connect-Instance',
+    'Disconnect-Instance',
+    'Get-Schema',
+    'Get-Table'
+)
 
 # Variables to export from this module
 # VariablesToExport = @()
diff --git a/test/Get-Schema.Tests.ps1 b/test/Get-Schema.Tests.ps1
