Update all id parameters to use guids instead of strings as datatypes closes #125 (#126)

* Change WorkspaceId and LakehouseId parameters to GUID Replace type for all `Id` input parameters from [String] to [Guid] #125

Updated parameter types for WorkspaceId and LakehouseId to GUID in multiple scripts to ensure better validation and consistency across the codebase. This change enhances the robustness of the functions by enforcing the correct data type.

Thank you!

* Refactor parameter types in PowerShell scripts to use [guid] for WorkspaceId, ReflexId, ReportId, and other identifiers

- Updated parameter types from [string] to [guid] in multiple scripts across the Public/Reflex, Public/Report, Public/Restore Points, Public/SQL Database, Public/Spark, Public/Tenant, Public/Users, Public/Utils, Public/Warehouse, and Public/Workspace directories.
- This change enhances type safety and ensures that only valid GUIDs are accepted for these parameters.

* Update parameter types to GUID in CHANGELOG and script

Updated the `WorkspaceId`, `CapacitiesIds`, and various other parameters to use the GUID datatype for consistency and improved type safety. This change enhances the clarity and reliability of the code.

Thank you!

* Fix syntax error in Export-FabricItem function

Corrected the conditional check for itemID to ensure proper functionality. This change enhances the reliability of the function when exporting items from a Fabric workspace.

Thank you!

* Add tests for parameter types in functions

This commit introduces a new test suite to verify that function parameters ending with 'id' are of type System.Guid. This ensures consistency and correctness in parameter types across the module.

Thank you!

* So that the parameter data type is correct

Updated the WorkspaceId parameter type from string to GUID for better validation and to ensure correct input format. This change enhances the function's robustness and prevents potential errors.

Thank you!

Author: SQLDBAWithABeard

CHANGELOG.md

@@ -15,6 +15,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Renamed `Get-FabricWorkspaceUsers` to match the singular form
 - Get-FabricSqlDatabase accepts Workspace as a pipeline, handles errors correctly and can filter by name (#117).
 
+Updated the `WorkspaceId`, `CapacitiesIds`,`CapacityId`,`CopyJobId`,`datamartId`,`DataPipelineId`,`DataWarehouseGUID`,`DomainId`,`EnvironmentId`,`EventhouseId`,`EventstreamId`,`ExternalDataShareId`,`ItemId`,`KQLDashboardId`,`KQLDatabaseId`,`KQLQuerysetId`,`LakehouseId`,`MirroredDatabaseId`,`MirroredWarehouseId`,`MLExperimentId`,`MLModelId`,`NotebookId`,`operationId`,`PaginatedReportId`,`ParentDomainId`,`parentEventhouseId`,`PrincipalId`,`ReflexId`,`ReportId`,`SemanticModelId`,`SparkCustomPoolId`,`SparkJobDefinitionId`,`SQLDatabaseId`,`SQLEndpointId`,`subscriptionID`,`UserId`,`WarehouseId`,`WorkspaceGUID`,`WorkspaceId`,`WorkspaceIds`,and `WorkspaceRoleAssignmentId` parameters to the datatype GUID [#125](https://github.com/dataplat/FabricTools/issues/125)
+
+
+
 ### Fixed
 ### Deprecated
 ### Removed

FabricTools.code-workspace

@@ -0,0 +1,7 @@
+{
+    "folders": [
+        {
+            "path": "."
+        }
+    ]
+}

source/Private/Get-FabricUri.ps1

@@ -34,11 +34,11 @@ function Get-FabricUri {
     param (
         $BaseUrl = 'api.powerbi.com',
         [parameter(Mandatory)]
-        [String]$WorkspaceGUID,
+        [guid]$WorkspaceGUID,
         [parameter(Mandatory)]
-        [String]$DataWarehouseGUID,
+        [guid]$DataWarehouseGUID,
 
-        [String]$BatchId
+        [guid]$BatchId
     )
 
     try {

source/Public/Capacity/Get-FabricCapacities.ps1

@@ -30,7 +30,7 @@ function Get-FabricCapacities {
     Param (
         # Optional parameter for subscription ID
         [Parameter(Mandatory = $false)]
-        [string]$subscriptionID
+        [guid]$subscriptionID
     )
 
     # Initialize an array to store the results

source/Public/Capacity/Get-FabricCapacity.ps1

@@ -32,7 +32,7 @@ function Get-FabricCapacity {
     param (
         [Parameter(Mandatory = $false)]
         [ValidateNotNullOrEmpty()]
-        [string]$capacityId,
+        [guid]$capacityId,
 
         [Parameter(Mandatory = $false)]
         [ValidateNotNullOrEmpty()]

source/Public/Capacity/Get-FabricCapacitySkus.ps1

@@ -28,7 +28,7 @@ Author: Kamil Nowinski
 
     Param(
         [Parameter(Mandatory = $true)]
-        [string]$subscriptionID,
+        [guid]$subscriptionID,
         [Parameter(Mandatory = $true)]
         [string]$ResourceGroupName,
         [Parameter(Mandatory = $true)]

source/Public/Capacity/Get-FabricCapacityState.ps1

@@ -34,7 +34,7 @@ Author: Ioana Bouariu
     # Define mandatory parameters for the subscription ID, resource group, and capacity.
     Param (
         [Parameter(Mandatory = $true)]
-        [string]$subscriptionID,
+        [guid]$subscriptionID,
         [Parameter(Mandatory = $true)]
         [string]$resourcegroup,
         [Parameter(Mandatory = $true)]

source/Public/Capacity/Get-FabricCapacityWorkload.ps1

@@ -28,7 +28,7 @@ Author: Ioana Bouariu
     # Define a mandatory parameter for the capacity ID.
     Param (
         [Parameter(Mandatory = $true)]
-        [string]$capacityID
+        [guid]$CapacityId
     )
 
     Confirm-TokenState

source/Public/Capacity/Resume-FabricCapacity.ps1

@@ -34,7 +34,7 @@ Author: Ioana Bouariu
     # Define parameters for the subscription ID, resource group, and capacity.
     Param (
         [Parameter(Mandatory = $true)]
-        [string]$subscriptionID,
+        [guid]$subscriptionID,
         [Parameter(Mandatory = $true)]
         [string]$resourcegroup,
         [Parameter(Mandatory = $true)]

source/Public/Capacity/Suspend-FabricCapacity.ps1

@@ -35,7 +35,7 @@ Author: Ioana Bouariu
     # Define parameters for the subscription ID, resource group, and capacity.
     Param (
         [Parameter(Mandatory = $true)]
-        [string]$subscriptionID,
+        [guid]$subscriptionID,
         [Parameter(Mandatory = $true)]
         [string]$resourcegroup,
         [Parameter(Mandatory = $true)]