Install-SPWebPartPack

Устанавливает указанный пакет веб-частей в указанном расположении.

Синтаксис

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>]

Описание

Этот командлет содержит несколько наборов параметров. Можно использовать параметры только из одного набора параметров; использование параметров из разных наборов не допускается. Дополнительные сведения об использовании наборов параметров см. в статье Наборы параметров командлета.

Командлет Install-SPWebPartPack устанавливает пакет веб-части в расположении параметра LiteralPath в локальной ферме. Пакет веб-части можно установить в определенном веб-приложении с помощью параметра WebApplication. Если веб-приложение не указано, пакет веб-части устанавливается во всех веб-приложениях.

Используйте параметр Language, чтобы указать язык пакета.

Используйте параметр GlobalInstall для установки пакета в глобальный кэш сборок (GAC). Сборкам в GAC предоставляется разрешение FullTrust, которое предоставляет этому пакету полный доступ ко всем системным ресурсам.

Используйте параметр Force, чтобы установить пакет, чтобы перезаписать существующий пакет веб-части с тем же именем или установить его в том же расположении.

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

Примеры

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

Install-SPWebPartPack "MyCustomWebPartPack" -LiteralPath "C:\mywebpart.wpp" -GlobalInstall

В этом примере пакет веб-части с именем MyCustomWebPartPack глобально устанавливается в ферме по пути c:/mywebpart.wpp.

Параметры

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-CompatibilityLevel

Specifies the version of templates to use when creating a new SPSite object. This value sets the initial CompatibilityLevel value for the site collection. When this parameter is not specified, the CompatibilityLevel will default to the highest possible version for the web application depending on the SiteCreationMode setting.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-GlobalInstall

Installs the Web Part package in the global assembly cache (GAC) rather than in the /bin directory of each Web application. This installation makes the Web Part globally accessible on the servers.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Language

Задает код языка для пакета веб-частей.

Type:UInt32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-LiteralPath

Указывает точный путь к пакету веб-частей.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Name

Указывает имя устанавливаемого пакета веб-частей.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WebApplication

Specifies the Web application on which to install the Web Part pack. If no Web application is specified, the Web Part pack is installed on all Web applications.

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Принудительно

Перезаписывает любой существующий пакет веб-частей, имеющий такое же имя или установленный в том же месте.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition