$Params = @{ 
		"Path" 				= 'D:\WorkingFolder\Articles\UtilityModule.psd1' 
		"Author" 			= 'Fake Author' 
		"CompanyName" 			= 'Fake Company' 
		"RootModule" 			= 'UtilityModule.psm1' 
		"CompatiblePSEditions" 		= @('Desktop','Core') 
		"FunctionsToExport" 		= @('Get-SharePointMember','Invoke-PowerAutomateFlow','New-TeamsMessage') 
		"CmdletsToExport" 		= @() 
		"VariablesToExport" 		= '' 
		"AliasesToExport" 		= @() 
		"Description" = 'Utility Module' 
	} 
New-ModuleManifest @Params

Wir exportieren Funktionen unter Verwendung von Export-ModuleMember, aber Performance Best Practices schreiben die Verwendung von leeren Arrays in der Moduldefinition vor. Aus unbekannten Gründen wird ein leeres Array unter VariablesToExport nicht korrekt exportiert, aber eine leere Zeichenfolge gibt ein leeres Array aus.
Durch Ausführen des Befehls New-ModuleManifest wird die Datei UtilityModule.psd1 erstellt. Viele Kommentarblöcke beziehen sich auf zusätzliche Konfigurationen. Im Folgenden haben wir alle zusätzlichen Kommentare entfernt, um die konfigurierten Parameter anzuzeigen.

UtilityModule.psd1

@{
	RootModule 		= 'UtilityModule.psm1' 
	ModuleVersion 		= '0.0.1' 
	CompatiblePSEditions 	= 'Desktop', 'Core' 
	GUID 			= 'dc18a919-f4bf-4da2-8c76-24b68fa33ef0' 
	Author 			= 'Fake Author' 
	CompanyName 		= 'Fake Company' 
	Copyright 		= '(c) Fake Author. All rights reserved.' 
	Description 		= 'UtilityModule'
	FunctionsToExport 	= 'Get-SharePointMember','Invoke-PowerAutomateFlow','New-TeamsMessage' 
	CmdletsToExport 	= @() 
	VariablesToExport 	= @() 
	AliasesToExport 	= @() 
	PrivateData 		= @{
	PSData 			= @{} 
	} 
}

Wenn alle Modulfunktionen dot-sourced sind, warum müssen wir dann die zu exportierenden Funktionen auflisten? Es gibt zwei Hauptgründe dafür, exportierte Funktionen explizit aufzulisten. Private Funktionen sollten nicht öffentlich gemacht werden, und exportierte Funktionen werden auf der Befehlszeile automatisch vervollständigt, auch wenn das Modul noch nicht geladen ist.

Als Nächstes müssen wir die Ladedatei des Moduls erstellen. Auch hier gibt es verschiedene Möglichkeiten, die unten beschriebene Methode hat sich aber als zuverlässig erwiesen. Im ersten Abschnitt werden nur Dateien mit func_-Präfixen abgerufen und mit dot-source versehen. Der zweite Abschnitt exportiert alle Funktionen im Public -Ordner

UtilityModule.psm1

Get-ChildItem (Split-Path $script:MyInvocation.MyCommand.Path) -Filter 'func_*.ps1' -Recurse | ForEach-Object { 
		. $_.FullName 
		} 
Get-ChildItem "$(Split-Path $script:MyInvocation.MyCommand.Path)\Public\*" -Filter 'func_*.ps1' -Recurse | ForEach-Object { 
		Export-ModuleMember -Function ($_.BaseName -Split "_")[1] 
		}

Function New-TeamsMessage { 
		[CmdletBinding()]
		Param( 
				[Parameter(Position = 0, Mandatory = $true)][String]$Message, 
				[Parameter(Position = 1, Mandatory = $true)][String]$Title, 
				[Parameter(Position = 2, Mandatory = $true)][String]$URI
		) 
		Process { 
				$Params = @{ 
						"URI" = 	$URI 
						"Method" = 	'POST' 
						"Body" = 	[PSCustomObject][Ordered]@{ 
									"@type" = 'MessageCard' 
									"@context" = 'http://schema.org/extension' 
									"summary" = $Title 
									"title" = $Title 
									"text" = ($Message | Out-String) 
								} 
						"ContentType" = 'application/json' 
						} 
				Invoke-RestMethod @Params | Out-Null 
		} 
	}

Invoke-PowerAutomateFlow

Als Nächstes definieren wir eine Power-AutomateFlow-Funktion. Am einfachsten geht dies mithilfe des HTTP-Triggers „Wenn eine HTTP-Anfrage empfangen wird“.

Function Invoke-PowerAutomateFlow { 
		[CmdletBinding()] 
		Param( 
				[Parameter(Position = 0, Mandatory = $true)][String]$URI 
				) 
				Process { 
					$Params = @{ 
							"URI" = $URI 
							"ContentType" = 'application/json' 
							"Method" = 'GET' 
					} 
					Invoke-WebRequest @Params 
				} 
}

Get-SharePointMember

Get-SharePointMember unterstützt unsere letzte Workflow-Anforderung, eine SharePoint-Mitgliederliste abzurufen.

Diese Funktion ruft alle SharePoint-Website-Mitglieder für eine bestimmte Website ab und zeigt die Ergebnisse an. Wenn die Ergebnisse in einer Gruppe weitergegeben werden, werden sie gefiltert.

Function Get-SharePointMember { 
		[CmdletBinding()] 
		Param( 
				[Parameter(Position = 0, Mandatory = $true)][String]$URI, 
				[Parameter(Position = 1)][String]$Group 
		) 
		
		Process { 
				$Params = @{ 
						"URI" = $URI 
				} 
				If ($Group) { 
						Get-SPOUser @Params | Where-Object -Contains $Group 
				} Else { 
						Get-SPOUser @Params 
				} 
		} 
}

Importieren und Testen des Moduls

Importieren Sie das Modul mit dem Befehl Import-Module und überprüfen Sie es auf Fehler. Als Nächstes verwenden wir den Befehl Get-Command, um alle exportierten Mitglieder zu sehen.

Import-Module -Name 'UtilityModule' 
Get-Command -Module 'UtilityModule'

Führen Sie zum Testen die verschiedenen Befehle aus und vergewissern Sie sich, dass sie so funktionieren, wie Sie es erwarten. Im folgenden Script führen wir die Funktionen aus und verwenden ihre Ausgabe.

# Get SharePoint Members 
$Members = Get-SharePointMember 
# Invoke 
Invoke-PowerAutomateFlow -URI 'https://...' 
New-TeamsMessage -Message $Groups -Title 'Group Members' -URI 'https://...'