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" -GlobalInstallEste 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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |
-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 Subscription Edition |