Wie lade ich Assemblys in PowerShell?

Der folgende PowerShell-Code

#Get a server object which corresponds to the default instance
$srv = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Server
... rest of the script ...

Gibt die folgende Fehlermeldung aus:

New-Object : Cannot find type [Microsoft.SqlServer.Management.SMO.Server]: make sure 
the assembly containing this type is loaded.
At C:\Users\sortelyn\ ... \tools\sql_express_backup\backup.ps1:6  char:8
+ $srv = New-Object -TypeName Microsoft.SqlServer.Management.SMO.Server
+        ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo          : InvalidType: (:) [New-Object], PSArgumentException
+ FullyQualifiedErrorId : TypeNotFound,Microsoft.PowerShell.Commands.NewObjectCommand

Jede Antwort im Internet schreibt, dass ich die Assembly laden muss - sicher kann ich das aus der Fehlermeldung lesen :-) - die Frage ist:

Wie lade ich die Assembly und lasse das Skript funktionieren?

LoadWithPartialNamewurde veraltet. Die empfohlene Lösung für PowerShell V3 ist die Verwendung des Add-TypeCmdlets, z.

Add-Type -Path 'C:\Program Files\Microsoft SQL Server\110\SDK\Assemblies\Microsoft.SqlServer.Smo.dll'

Es gibt mehrere verschiedene Versionen, und Sie möchten möglicherweise eine bestimmte Version auswählen. :-)

[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Smo")

Die meisten Menschen wissen inzwischen, dass dies System.Reflection.Assembly.LoadWithPartialNameveraltet ist, aber es stellt sich heraus, dass Add-Type -AssemblyName Microsoft.VisualBasic es sich nicht viel besser verhält alsLoadWithPartialName :

Anstatt zu versuchen, Ihre Anfrage im Kontext Ihres Systems zu analysieren, betrachtet [Add-Type] eine statische interne Tabelle, um den "Teilnamen" in einen "vollständigen Namen" zu übersetzen.

Wenn Ihr "Teilname" nicht in der Tabelle angezeigt wird, schlägt Ihr Skript fehl.

Wenn auf Ihrem Computer mehrere Versionen der Baugruppe installiert sind, können Sie keinen intelligenten Algorithmus auswählen. Sie werden das bekommen, was in ihrer Tabelle erscheint, wahrscheinlich das ältere, veraltete.

Wenn die von Ihnen installierten Versionen alle neuer als die veraltete in der Tabelle sind, schlägt Ihr Skript fehl.

Add-Type hat keinen intelligenten Parser von "Teilnamen" wie .LoadWithPartialNames.

Was Microsoft sagt, dass Sie eigentlich tun sollen, ist ungefähr so:

Add-Type -AssemblyName 'Microsoft.VisualBasic, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a'

Oder, wenn Sie den Weg kennen, so etwas:

Add-Type -Path 'C:\WINDOWS\Microsoft.Net\assembly\GAC_MSIL\Microsoft.VisualBasic\v4.0_10.0.0.0__b03f5f7f11d50a3a\Microsoft.VisualBasic.dll'

Dieser lange Name für die Versammlung ist bekannt als starker Name bezeichnet , der sowohl für die Version als auch für die Assembly eindeutig ist und manchmal auch als vollständiger Name bezeichnet wird.

Dies lässt jedoch einige Fragen offen:

1. Wie bestimme ich den starken Namen dessen, was tatsächlich mit einem bestimmten Teilnamen auf mein System geladen wird?

   [System.Reflection.Assembly]::LoadWithPartialName($TypeName).Location; [System.Reflection.Assembly]::LoadWithPartialName($TypeName).FullName;

Diese sollten auch funktionieren:

Add-Type -AssemblyName $TypeName -PassThru | Select-Object -ExpandProperty Assembly | Select-Object -ExpandProperty FullName -Unique

2. Wenn ich möchte, dass mein Skript immer eine bestimmte Version einer DLL verwendet, ich aber nicht sicher bin, wo sie installiert ist, wie kann ich den starken Namen der DLL ermitteln?

   [System.Reflection.AssemblyName]::GetAssemblyName($Path).FullName;

Oder:

Add-Type $Path -PassThru | Select-Object -ExpandProperty Assembly | Select-Object -ExpandProperty FullName -Unique

3. Wie bestimme ich den DLL-Pfad, wenn ich den starken Namen kenne?

   [Reflection.Assembly]::Load('Microsoft.VisualBasic, Version=10.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a').Location;

4. Und in ähnlicher Weise, wenn ich den Typnamen meiner Verwendung kenne, woher weiß ich, von welcher Baugruppe sie stammt?

   [Reflection.Assembly]::GetAssembly([Type]).Location [Reflection.Assembly]::GetAssembly([Type]).FullName

5. Wie sehe ich, welche Baugruppen verfügbar sind?

Ich schlage das GAC PowerShell-Modul vor . Get-GacAssembly -Name 'Microsoft.SqlServer.Smo*' | Select Name, Version, FullNamefunktioniert ziemlich gut.

6. Wie kann ich die verwendete Liste Add-Typeanzeigen?

Das ist etwas komplexer. Ich kann beschreiben, wie für jede Version von PowerShell mit einem .Net-Reflektor darauf zugegriffen werden kann (siehe das Update unten für PowerShell Core 6.0).

Stellen Sie zunächst fest, aus welcher Bibliothek Sie Add-Typestammen:

Get-Command -Name Add-Type | Select-Object -Property DLL

Öffnen Sie die resultierende DLL mit Ihrem Reflektor. Ich habe ILSpy dafür verwendet, weil es FLOSS ist, aber jeder C # -Reflektor sollte funktionieren. Öffnen Sie diese Bibliothek und schauen Sie hinein Microsoft.Powershell.Commands.Utility. Unter Microsoft.Powershell.Commandssollte es seinAddTypeCommand .

In der Codeliste dafür gibt es eine private Klasse InitializeStrongNameDictionary(). Das listet das Wörterbuch auf, das die Kurznamen den starken Namen zuordnet. Es gibt fast 750 Einträge in der Bibliothek, die ich mir angesehen habe.

Update: Jetzt, da PowerShell Core 6.0 Open Source ist. Für diese Version können Sie die obigen Schritte überspringen und den Code direkt online in ihrem GitHub-Repository anzeigen . Ich kann jedoch nicht garantieren, dass dieser Code mit einer anderen Version von PowerShell übereinstimmt.

Wenn Sie eine Assembly während der Dauer der PowerShell-Sitzung laden möchten, ohne sie zu sperren, verwenden Sie Folgendes :

$bytes = [System.IO.File]::ReadAllBytes($storageAssemblyPath)
[System.Reflection.Assembly]::Load($bytes)

Wo $storageAssemblyPath ist der Dateipfad Ihrer Assembly?

Dies ist besonders nützlich, wenn Sie die Ressourcen in Ihrer Sitzung bereinigen müssen. Zum Beispiel in einem Bereitstellungsskript.

Hier sind einige Blog-Beiträge mit zahlreichen Beispielen zum Laden von Assemblys in PowerShell v1, v2 und v3.

Die Möglichkeiten umfassen:

• dynamisch aus einer Quelldatei
• dynamisch aus einer Baugruppe
• Verwenden anderer Codetypen, dh F #

v1.0 Laden von .NET-Assemblys in einer PowerShell-Sitzung
v2.0 Verwenden von CSharp-Code (C #) in PowerShell-Skripten 2.0
v3.0 Verwenden von .NET Framework-Assemblys in Windows PowerShell

Sie können die gesamte * .dll-Assembly mit laden

$Assembly = [System.Reflection.Assembly]::LoadFrom("C:\folder\file.dll");

Keine der Antworten hat mir geholfen, daher veröffentliche ich die für mich funktionierende Lösung. Ich musste lediglich das SQLPS-Modul importieren. Dies wurde mir klar, als ich versehentlich den Befehl Restore-SqlDatabase ausführte und anfing zu arbeiten Die Assembly wurde in diesem Modul irgendwie referenziert.

Renn einfach:

Import-module SQLPS

Hinweis: Vielen Dank an Jason, dass er festgestellt hat, dass SQLPS veraltet ist

Führen Sie stattdessen Folgendes aus:

Import-Module SqlServer

oder

Install-Module SqlServer

[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Smo") arbeitete für mich.

Sie könnten verwenden LoadWithPartialName. Dies ist jedoch wie gesagt veraltet.

Sie können in der Tat Add-Typemitmachen und zusätzlich zu den anderen Antworten, wenn Sie nicht den vollständigen Pfad der DLL-Datei angeben möchten, können Sie einfach Folgendes tun:

Add-Type -AssemblyName "Microsoft.SqlServer.Management.SMO"

Für mich gab dies einen Fehler zurück, da ich SQL Server nicht installiert habe (ich denke), aber mit der gleichen Idee konnte ich die Windows Forms-Assembly laden:

Add-Type -AssemblyName "System.Windows.Forms"

Den genauen Assemblernamen der jeweiligen Klasse finden Sie auf der MSDN-Site:

Stellen Sie sicher, dass die folgenden Funktionen der Reihe nach installiert sind

1. Microsoft System CLR-Typen für SQL Server
2. Gemeinsame Microsoft SQL Server-Verwaltungsobjekte
3. Microsoft Windows PowerShell-Erweiterungen

Möglicherweise müssen Sie auch laden

Add-Type -Path "C:\Program Files\Microsoft SQL Server\110\SDK\Assemblies\Microsoft.SqlServer.Smo.dll"
Add-Type -Path "C:\Program Files\Microsoft SQL Server\110\SDK\Assemblies\Microsoft.SqlServer.SqlWmiManagement.dll"

Fügen Sie die Baugruppenreferenzen oben hinzu.

#Load the required assemblies SMO and SmoExtended.
[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.SMO") | Out-Null
[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.SmoExtended") | Out-Null