Uploading BPC STARS conent

2025-09-02 13:37:19 -04:00
parent 7fb5a9f1ac
commit 7c07d8173f
86 changed files with 48463 additions and 0 deletions
--- a/Version/1.0/PSAppDeployToolkit.Extensions/PSAppDeployToolkit.Extensions.psm1
+++ b/Version/1.0/PSAppDeployToolkit.Extensions/PSAppDeployToolkit.Extensions.psm1
@@ -0,0 +1,106 @@
+<#
+
+.SYNOPSIS
+PSAppDeployToolkit.Extensions - Provides the ability to extend and customize the toolkit by adding your own functions that can be re-used.
+
+.DESCRIPTION
+This module is a template that allows you to extend the toolkit with your own custom functions.
+
+This module is imported by the Invoke-AppDeployToolkit.ps1 script which is used when installing or uninstalling an application.
+
+PSAppDeployToolkit is licensed under the GNU LGPLv3 License - (C) 2024 PSAppDeployToolkit Team (Sean Lillis, Dan Cunningham, Muhammad Mashwani, Mitch Richters, Dan Gough).
+
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the
+Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
+for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+.LINK
+https://psappdeploytoolkit.com
+
+#>
+
+##*===============================================
+##* MARK: MODULE GLOBAL SETUP
+##*===============================================
+
+# Set strict error handling across entire module.
+$ErrorActionPreference = [System.Management.Automation.ActionPreference]::Stop
+$ProgressPreference = [System.Management.Automation.ActionPreference]::SilentlyContinue
+Set-StrictMode -Version 1
+
+
+##*===============================================
+##* MARK: FUNCTION LISTINGS
+##*===============================================
+
+function New-ADTExampleFunction
+{
+    <#
+    .SYNOPSIS
+        Basis for a new PSAppDeployToolkit extension function.
+
+    .DESCRIPTION
+        This function serves as the basis for a new PSAppDeployToolkit extension function.
+
+    .INPUTS
+        None
+
+        You cannot pipe objects to this function.
+
+    .OUTPUTS
+        None
+
+        This function does not return any output.
+
+    .EXAMPLE
+        New-ADTExampleFunction
+
+        Invokes the New-ADTExampleFunction function and returns any output.
+    #>
+
+    [CmdletBinding()]
+    param
+    (
+    )
+
+    begin
+    {
+        # Initialize function.
+        Initialize-ADTFunction -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState
+    }
+
+    process
+    {
+        try
+        {
+            try
+            {
+            }
+            catch
+            {
+                # Re-writing the ErrorRecord with Write-Error ensures the correct PositionMessage is used.
+                Write-Error -ErrorRecord $_
+            }
+        }
+        catch
+        {
+            # Process the caught error, log it and throw depending on the specified ErrorAction.
+            Invoke-ADTFunctionErrorHandler -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState -ErrorRecord $_
+        }
+    }
+
+    end
+    {
+        # Finalize function.
+        Complete-ADTFunction -Cmdlet $PSCmdlet
+    }
+}
+
+
+##*===============================================
+##* MARK: SCRIPT BODY
+##*===============================================
+
+# Announce successful importation of module.
+Write-ADTLogEntry -Message "Module [$($MyInvocation.MyCommand.ScriptBlock.Module.Name)] imported successfully." -ScriptSection Initialization