Compartilhar via

Install-SPSolution

Módulo:
SharePointServer module

Implanta uma solução do SharePoint instalada no farm.

Sintaxe

Deploy 

Install-SPSolution
    [-Identity] <SPSolutionPipeBind>
    [-AllWebApplications]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CASPolicies]
    [-CompatibilityLevel <String>]
    [-Confirm]
    [-Force]
    [-FullTrustBinDeployment]
    [-GACDeployment]
    [-Language <UInt32>]
    [-Local]
    [-Time <String>]
    [-WebApplication <SPWebApplicationPipeBind>]
    [-WhatIf]
    [<CommonParameters>]

Synchronize 

Install-SPSolution
    [[-Identity] <SPSolutionPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Language <UInt32>]
    [-Synchronize]
    [-WhatIf]
    [<CommonParameters>]

Description

Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como utilizar conjuntos de parâmetros, veja Conjuntos de Parâmetros de Cmdlet (https://learn.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets?view=powershell-5.1).

O cmdlet Install-SPSolution implanta uma solução do SharePoint instalada no farm. Use o cmdlet Add-SPSolution para instalar um pacote de solução do SharePoint no farm.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment

Este exemplo implanta a solução do SharePoint instalada contoso_solution.wsp no farm e especifica que o GAC poderá ser implantado para a nova solução do SharePoint.

EXEMPLO 2

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment -CompatibilityLevel {14,15}

Este exemplo implanta a solução do SharePoint instalada em uma solução adicionada anteriormente, para que possa ser usada corretamente em ambos os conjuntos de sites de modo 14 e 15.

Parâmetros

-AllWebApplications

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que a nova solução do SharePoint será implantada para todos os aplicativos Web do SharePoint no farm.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CASPolicies

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que as políticas CAS (segurança de acesso de código) podem ser implantadas na nova solução do SharePoint.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CompatibilityLevel

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica se a instalação da solução será em um diretório de versão específico com base em CompatibilityLevel. O comportamento padrão se este parâmetro não for especificado é instalar a solução somente no diretório de versão com base na versão rastreada no manifesto do arquivo cab da solução.

Os valores válidos são:

--14

--15

--14,15

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Impõe a implantação de uma nova solução do SharePoint.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FullTrustBinDeployment

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica que a confiança total da implantação da Lixeira é permitida. Este parâmetro deve ser usado se a solução é totalmente confiável.

O assembly Lixeira é um assembly instalado no diretório Lixeira do servidor virtual. O assembly no pacote terá o atributo DeploymentTarget=WebApplication definido. Para saber mais sobre o assembly Lixeira, confira Elemento Assembly

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GACDeployment

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica que o GAC (cache de assembly global) pode ser implantado para a nova solução do SharePoint.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica a solução do SharePoint a ser implantada.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome autêntico de uma solução do SharePoint (por exemplo, SPSolution1) ou uma instância de um objeto SPSolution autêntico.

Propriedades do parâmetro

Tipo:SPSolutionPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
Synchronize
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Language

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica um idioma para a solução quando um pacote de idiomas da solução é implantado. Se esse parâmetro não for especificado, será assumido o valor zero ("0"). Use zero para soluções que são válidas para todos os idiomas.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Local

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Implanta a solução no servidor ativo.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Synchronize

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Sincroniza todas as soluções ou a solução especificada no farm local.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Synchronize
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Time

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica quando a solução será implantada. O valor padrão é a implantação imediata.

O tipo deve ser um valor de DateTime válido, no formato 2010, 5, 1.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WebApplication

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Implanta a solução do SharePoint para o aplicativo Web do SharePoint especificado.

O valor deve estar em um dos seguintes formatos:

--Um GUID autêntico, no formato 12345678-90ab-cdef-1234-567890bcdefgh

--Um nome autêntico de uma aplicação Web do SharePoint (por exemplo, MyOfficeApp1)

--Uma instância de um objeto SPWebApplication autêntico.

Propriedades do parâmetro

Tipo:SPWebApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Deploy
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.