Поделиться через


Install-SPSolution

Развертывает установленное решение SharePoint в ферме.

Синтаксис

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

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в разделе Наборы параметров командлетов (https://learn.microsoft.com/powershell/scripting/developer/cmdlet/cmdlet-parameter-sets?view=powershell-5.1).

Командлет Install-SPSolution развертывает установленное решение SharePoint в ферме. Чтобы добавить в ферму пакет решения SharePoint, используйте командлет Add-SPSolution.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

------------------ПРИМЕР 1------------------

Install-SPSolution -Identity contoso_solution.wsp -GACDeployment

В этом примере установленное решение SharePoint contoso_solution.wsp развертывается в ферме; кроме того, указывается, что для него можно развернуть глобальный кэш сборок.

------------------ПРИМЕР 2------------------

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

В этом примере выполняется развертывание установленного решения SharePoint и устанавливается ранее добавленное решение, чтобы оно могло использоваться в семействах сайтов в режиме 14 и 15.

Параметры

-AllWebApplications

Указывает, что новое решение SharePoint будет развернуто для всех веб-приложений SharePoint в ферме.

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

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

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

-CASPolicies

Указывает, что для нового решения SharePoint могут быть развернуты политики разграничения доступа кода.

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

-CompatibilityLevel

Указывает, следует ли установить решение в каталог определенной версии на основе параметра CompatibilityLevel. Если этот параметр не указан, по умолчанию решение устанавливается только в каталог версии на основе версии из манифеста CAB-файла решения.

Допустимые значения:

--14

--15

--14,15

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

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: 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

Предписывает принудительное развертывание нового решения SharePoint.

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

-FullTrustBinDeployment

Определяет допустимость развертывания сборки bin с полным доверием. Этот параметр следует использовать в том случае, если решение является полностью доверенным.

Сборка bin устанавливается в каталог bin на виртуальном сервере. Этой сборке в пакете присвоен атрибут DeploymentTarget=WebApplication. Дополнительные сведения о сборке bin см. в разделе Элемент Assembly.

Type:SwitchParameter
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

-GACDeployment

Указывает, что для нового решения SharePoint может быть развернут глобальный кэш сборок.

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

-Identity

Указывает на решение SharePoint, которое будет развернуто.

Значением должен быть подлинный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh, имя решения SharePoint (например, SPSolution1) или экземпляр подлинного объекта SPSolution.

Type:SPSolutionPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Language

Язык решения при развертывании языкового пакета. Если этот параметр не задан, предполагается, что он равен нулю ("0"). Нулевое значение используется для решений, применимых для всех языков.

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

-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

-Synchronize

Предписывает синхронизацию всех решений или определенного решения в локальной ферме.

Type:SwitchParameter
Position:Named
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

-Time

Указывает время развертывания решения. Значение по умолчанию предписывает выполнить развертывание немедленно.

Тип значения: допустимое значение DateTime в формате 2010, 5, 1.

Type:String
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

-WebApplication

Предписывает развертывание решения SharePoint для указанного веб-приложения SharePoint.

Возможные значения:

--Подлинный GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh

--Подлинное имя веб-приложения SharePoint (например, MyOfficeApp1)

--Экземпляр аутентичного объекта SPWebApplication.

Type:SPWebApplicationPipeBind
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

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: 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