Como carregar montagens no PowerShell?

O seguinte código do PowerShell

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

Dá a seguinte mensagem de erro:

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

Todas as respostas na Internet escrevem que eu tenho que carregar o assembly - com certeza eu posso ler isso na mensagem de erro :-) - a pergunta é:

Como você carrega a montagem e faz o script funcionar?

LoadWithPartialNamefoi descontinuado. A solução recomendada para o PowerShell V3 é usar o Add-Typecmdlet, por exemplo:

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

Existem várias versões diferentes e você pode escolher uma versão específica. :-)

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

A maioria das pessoas sabe até agora que System.Reflection.Assembly.LoadWithPartialNameestá obsoleta, mas acontece queAdd-Type -AssemblyName Microsoft.VisualBasic não se comporta muito melhor do queLoadWithPartialName :

Em vez de tentar analisar sua solicitação no contexto do seu sistema, o [Add-Type] analisa uma tabela interna estática para converter o "nome parcial" em um "nome completo".

Se o seu "nome parcial" não aparecer na tabela, o script falhará.

Se você tiver várias versões do assembly instaladas no seu computador, não há algoritmo inteligente para escolher entre elas. Você receberá o que aparecer na tabela deles, provavelmente o mais antigo e desatualizado.

Se as versões instaladas forem todas mais novas que as obsoletas da tabela, seu script falhará.

Add-Type não possui um analisador inteligente de "nomes parciais", como .LoadWithPartialNames.

O que a Microsoft diz que você realmente deve fazer é algo como isto:

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

Ou, se você conhece o caminho, algo como isto:

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

Esse nome longo dado para a montagem é conhecido como nome forte , que é exclusivo da versão e do assembly, e também é conhecido como nome completo.

Mas isso deixa algumas perguntas sem resposta:

1. Como determino o nome forte do que realmente está sendo carregado no meu sistema com um nome parcial fornecido?

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

Estes também devem funcionar:

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

2. Se quiser que meu script sempre use uma versão específica de uma .dll, mas não tenha certeza de onde está instalado, como determino qual é o nome forte da .dll?

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

Ou:

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

3. Se eu souber o nome forte, como determino o caminho .dll?

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

4. E, de maneira semelhante, se eu sei o nome do tipo do que estou usando, como sei de que montagem ele está vindo?

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

5. Como vejo quais montagens estão disponíveis?

Sugiro o módulo GAC PowerShell . Get-GacAssembly -Name 'Microsoft.SqlServer.Smo*' | Select Name, Version, FullNamefunciona muito bem.

6. Como posso ver a lista que Add-Typeusa?

Isso é um pouco mais complexo. Posso descrever como acessá-lo para qualquer versão do PowerShell com um refletor .Net (consulte a atualização abaixo para o PowerShell Core 6.0).

Primeiro, descubra de que biblioteca Add-Typevem:

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

Abra a DLL resultante com seu refletor. Eu usei o ILSpy para isso porque é FLOSS, mas qualquer refletor em C # deve funcionar. Abra essa biblioteca e veja Microsoft.Powershell.Commands.Utility. Abaixo Microsoft.Powershell.Commands, deve haver AddTypeCommand.

Na lista de códigos para isso, há uma classe privada InitializeStrongNameDictionary(),. Isso lista o dicionário que mapeia os nomes abreviados para os nomes fortes. Há quase 750 entradas na biblioteca que eu olhei.

Atualização: Agora que o PowerShell Core 6.0 é de código aberto. Para essa versão, você pode pular as etapas acima e ver o código diretamente online no repositório do GitHub . Não posso garantir que esse código corresponda a qualquer outra versão do PowerShell, no entanto.

Se você deseja carregar uma montagem sem travá-la durante a sessão do PowerShell , use o seguinte:

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

Onde $storageAssemblyPath está o caminho do arquivo da sua montagem.

Isso é especialmente útil se você precisar limpar os recursos da sua sessão. Por exemplo, em um script de implantação.

Aqui estão algumas postagens de blog com vários exemplos de maneiras de carregar montagens no PowerShell v1, v2 e v3.

As maneiras incluem:

• dinamicamente a partir de um arquivo de origem
• dinamicamente a partir de uma montagem
• usando outros tipos de código, ou seja, F #

v1.0 Como carregar assemblies .NET em uma sessão do PowerShell
v2.0 usando o código CSharp (C #) nos scripts do PowerShell 2.0
v3.0 usando assemblies do .NET Framework no Windows PowerShell

Você pode carregar o assembly * .dll inteiro com

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

Nenhuma das respostas me ajudou, então, eu estou postando a solução que funcionou para mim. Tudo o que eu precisava fazer era importar o módulo SQLPS. Percebi isso quando, por acidente, executei o comando Restore-SqlDatabase e comecei a trabalhar, o que significa que a montagem foi referenciada nesse módulo de alguma forma.

Apenas corra:

Import-module SQLPS

Nota: Obrigado Jason por observar que o SQLPS está obsoleto

em vez disso, execute:

Import-Module SqlServer

ou

Install-Module SqlServer

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

Você poderia usar LoadWithPartialName. No entanto, isso foi preterido como eles disseram.

Você pode acompanhar Add-Typee, além das outras respostas, se não desejar especificar o caminho completo do arquivo .dll, basta:

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

Para mim, isso retornou um erro, porque eu não tenho o SQL Server instalado (eu acho), no entanto, com essa mesma ideia, consegui carregar o assembly do Windows Forms:

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

Você pode descobrir o nome exato do assembly pertencente à classe específica no site MSDN:

Verifique se os recursos abaixo estão instalados em ordem

1. Tipos de CLR do sistema Microsoft para SQL Server
2. Objetos de gerenciamento compartilhado do Microsoft SQL Server
3. Extensões do Microsoft Windows PowerShell

Também pode ser necessário carregar

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"

Adicione as referências de montagem na parte superior.

#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