Как загрузить сборки в PowerShell?

Следующий код PowerShell

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

Выдает следующее сообщение об ошибке:

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

Каждый ответ в Интернете пишет, что я должен загрузить сборку - конечно, я могу прочитать это из сообщения об ошибке :-) - вопрос такой:

Как загрузить сборку и заставить скрипт работать?

LoadWithPartialNameбыл объявлен устаревшим Рекомендуемое решение для PowerShell V3 - использовать Add-Typeкомандлет, например:

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

Существует несколько разных версий, и вы можете выбрать конкретную версию. :-)

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

Большинство людей к настоящему моменту знают, что System.Reflection.Assembly.LoadWithPartialNameэто устарело, но оказывается, что Add-Type -AssemblyName Microsoft.VisualBasic не ведет себя намного лучше, чемLoadWithPartialName :

Вместо того, чтобы пытаться анализировать ваш запрос в контексте вашей системы, [Add-Type] просматривает статическую внутреннюю таблицу, чтобы перевести «частичное имя» в «полное имя».

Если ваше «частичное имя» не отображается в их таблице, ваш сценарий потерпит неудачу.

Если на вашем компьютере установлено несколько версий сборки, интеллектуального алгоритма для выбора между ними не существует. Вы получите то, что появится в их таблице, вероятно, старое, устаревшее.

Если все версии, которые вы установили, являются более новыми, чем устаревшая в таблице, ваш скрипт завершится ошибкой.

Add-Type не имеет интеллектуального синтаксического анализатора типа «частичных имен» .LoadWithPartialNames.

Microsoft говорит, что на самом деле вы должны делать что-то вроде этого:

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

Или, если вы знаете путь, что-то вроде этого:

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

Это длинное имя, данное для сборки, называется строгим именем , которое уникально как для версии, так и для сборки, а также иногда называется полным именем.

Но это оставляет пару вопросов без ответа:

1. Как определить строгое имя того, что на самом деле загружается в моей системе с данным частичным именем?

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

Они также должны работать:

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

2. Если я хочу, чтобы в моем сценарии всегда использовалась определенная версия .dll, но я не могу быть уверен в том, где он установлен, как определить, какое строгое имя используется в .dll?

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

Или:

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

3. Если я знаю строгое имя, как мне определить путь к .dll?

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

4. И в том же духе, если я знаю имя типа того, что я использую, как я узнаю, из какой сборки это происходит?

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

5. Как посмотреть какие сборки доступны?

Я предлагаю модуль GAC PowerShell . Get-GacAssembly -Name 'Microsoft.SqlServer.Smo*' | Select Name, Version, FullNameработает довольно хорошо

6. Как я могу увидеть список, который Add-Typeиспользует?

Это немного сложнее. Я могу описать, как получить к нему доступ для любой версии PowerShell с помощью отражателя .Net (см. Обновление ниже для PowerShell Core 6.0).

Сначала выясните, из какой библиотеки Add-Typeпроисходит:

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

Откройте полученную DLL вашим отражателем. Я использовал ILSpy для этого, потому что это FLOSS, но любой отражатель C # должен работать. Откройте эту библиотеку и посмотрите Microsoft.Powershell.Commands.Utility. Под Microsoft.Powershell.Commands, там должно быть AddTypeCommand.

В листинге кода для этого есть закрытый класс InitializeStrongNameDictionary(). Это перечисляет словарь, который отображает короткие имена в строгие имена. В библиотеке я посмотрел почти 750 записей.

Обновление: теперь, когда PowerShell Core 6.0 с открытым исходным кодом. Для этой версии вы можете пропустить описанные выше шаги и увидеть код прямо онлайн в их репозитории GitHub . Однако я не могу гарантировать, что этот код соответствует любой другой версии PowerShell.

Если вы хотите загрузить сборку без блокировки во время сеанса PowerShell , используйте это:

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

Где $storageAssemblyPathнаходится путь к файлу вашей сборки.

Это особенно полезно, если вам нужно очистить ресурсы в течение вашего сеанса. Например, в сценарии развертывания.

Вот некоторые сообщения в блоге с многочисленными примерами способов загрузки сборок в PowerShell v1, v2 и v3.

Способы включают в себя:

• динамически из исходного файла
• динамически из сборки
• используя другие типы кода, например, F #

v1.0 Как загрузить сборки .NET в сеансе PowerShell
v2.0 Использование кода CSharp (C #) в сценариях PowerShell 2.0
v3.0 Использование сборок .NET Framework в Windows PowerShell

Вы можете загрузить всю сборку * .dll с помощью

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

Ни один из ответов не помог мне, поэтому я публикую решение, которое сработало для меня, все, что мне нужно было сделать, это импортировать модуль SQLPS. Я понял это, когда случайно запустил команду Restore-SqlDatabase и начал работать, то есть сборка упоминалась в этом модуле как-то.

Просто беги:

Import-module SQLPS

Примечание: спасибо Джейсону за то, что он отметил, что SQLPS устарел

вместо этого запустите:

Import-Module SqlServer

или

Install-Module SqlServer

[System.Reflection.Assembly]::LoadWithPartialName("Microsoft.SqlServer.Smo") работал на меня.

Вы могли бы использовать LoadWithPartialName. Тем не менее, это устарело, как они сказали.

Вы действительно можете согласиться Add-Type, и в дополнение к другим ответам, если вы не хотите указывать полный путь к файлу .dll, вы можете просто сделать:

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

Для меня это вернуло ошибку, потому что у меня не установлен SQL Server (я думаю), однако, с этой же идеей я смог загрузить сборку Windows Forms:

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

Точное имя сборки, принадлежащее определенному классу, можно узнать на сайте MSDN:

Убедитесь, что нижеуказанные функции установлены в порядке

1. Типы Microsoft CLR для SQL Server
2. Общие объекты управления Microsoft SQL Server
3. Расширения Microsoft Windows PowerShell

Также вам может понадобиться загрузить

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"

Добавьте ссылки на сборки вверху.

#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