Install-SPWebPartPack
Instala o pacote de Web Parts especificado no local indicado.
Syntax
Install-SPWebPartPack
[-LiteralPath] <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-GlobalInstall]
[-Language <UInt32>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[-CompatibilityLevel <String>]
[<CommonParameters>]
Install-SPWebPartPack
[-Name] <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Force]
[-GlobalInstall]
[-Language <UInt32>]
[-WebApplication <SPWebApplicationPipeBind>]
[-WhatIf]
[-CompatibilityLevel <String>]
[<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 usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.
O cmdlet Install-SPWebPartPack instala o pacote de Web Parts, no local do parâmetro LiteralPath, no farm local. O pacote de Web Parts pode ser instalado em um aplicativo Web específico usando o parâmetro WebApplication. Se um aplicativo Web não for especificado, o pacote de Web Parts será instalado em todos os aplicativos da Web.
Use o parâmetro Language para especificar o idioma de um pacote.
Use o parâmetro GlobalInstall para instalar o pacote no GAC (cache de assembly global). Os assemblies no GAC recebem a permissão FullTrust, que dá a esse pacote acesso completo a todos os recursos do sistema.
Use o parâmetro Force a fim de instalar o pacote para substituir qualquer pacote de Web Parts existente pelo mesmo nome ou instalado no mesmo local.
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------------------
Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall
Este exemplo instala o Pacote de Web Parts chamado MyCustomWebPartPack globalmente no farm a partir do caminho c:/mywebpart.wpp.
Parâmetros
-AssignmentCollection
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.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-CompatibilityLevel
Especifica a versão dos modelos a serem usados ao criar um novo objeto SPSite. Este valor define o valor CompatibilityLevel inicial para o conjunto de sites. Quando este parâmetro não é especificado, o CompatibilityLevel será padrão para a maior versão possível do aplicativo Web dependendo da configuração SiteCreationMode.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Force
Substitui qualquer pacote de Web Parts existente pelo mesmo nome ou instalado no mesmo local.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-GlobalInstall
Instala o pacote de Web Parts no GAC, não no diretório /bin de cada aplicativo Web. Essa instalação torna a Web Part globalmente acessível nos servidores.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Language
Especifica a ID de idioma para o pacote de Web Parts.
Type: | UInt32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-LiteralPath
Especifica o caminho exato para o pacote de Web Parts.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Name
Especifica o nome do pacote de Web Parts a ser instalado.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WebApplication
Especifica o aplicativo Web no qual instalar o pacote de Web Parts. Se nenhum aplicativo Web for especificado, o pacote de Web Parts será instalado em todos os aplicativos da Web.
Type: | SPWebApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
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
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |