New-SPWOPIBinding
Создает новую привязку для связи расширений имен файлов или приложений с действиями в текущей ферме SharePoint, где выполняется этот командлет.
Синтаксис
New-SPWOPIBinding
-ServerName <String>
[-Action <String>]
[-AllowHTTP]
[-Application <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Extension <String>]
[-FileName <String>]
[-ProgId <String>]
[-WhatIf]
[<CommonParameters>]
Описание
Командлет New-SPWOPIBinding
связывает расширения имен файлов или приложения с действиями в текущей ферме SharePoint, где выполняется этот командлет.
Каждая привязка позволяет использовать приложение WOPI для просмотра или редактирования файлов в библиотеке SharePoint.
Например, когда пользователь видит документ Word в списке документов SharePoint, в списке SharePoint отображаются доступные параметры для просмотра или редактирования документа на основе действий, привязанных к Word в этой ферме SharePoint.
Чтобы использовать приложение WOPI, например сервер, на котором выполняется Office веб-приложения Server, для Office веб-приложения, необходимо выполнить этот командлет в ферме SharePoint, прежде чем использовать веб-приложения Office.
Если вы запускаете New-SPWOPIBinding
для расширения имени приложения или файла, где привязка (или связь) уже существует, командлет завершится ошибкой.
Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.
Примеры
------------------ПРИМЕР 1-----------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com"
В этом примере показано создание привязок для всех приложений и расширений файлов, поддерживаемых приложением WOPI, в текущей ферме SharePoint, где выполняется данный командлет.
--------------------------ПРИМЕР 2------------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com" -Application "Excel"
В этом примере показана связь Excel со всеми действиями, поддерживаемыми приложением WOPI для Excel в текущей ферме SharePoint, где выполняется данный командлет.
Параметры
-Action
Задает действие для привязки.
Например, "view", "edit" и "embedview". Чтобы получить список действий, поддерживаемых приложением WOPI, выполните команду Get-SPWOPIBinding
.
Как правило, этот параметр не рекомендуется использовать.
Некоторые функции в SharePoint могут быть недоступны при указании определенных действий без указания других.
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 |
-AllowHTTP
Указывает, может ли командлет использовать протокол HTTP для обнаружения поддерживаемых приложением WOPI функций.
Если задано значение True, сведения об обнаружении из приложения WOPI будут отправлены через незащищенное соединение.
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 |
-Application
Задает приложения для привязки.
Возможные приложения: "Word", "Excel", "PowerPoint" или "OneNote". Выполните команду Get-SPWOPIBinding
, чтобы получить полный список приложений, поддерживаемых приложением WOPI.
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 |
-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 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Extension
Задает расширения файлов для привязки.
Выполните команду Get-SPWOPIBinding
, чтобы получить список расширений имен файлов, поддерживаемых приложением WOPI.
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 |
-FileName
Задает путь файла XML, который содержит сведения об обнаружении для приложения WOPI.
Можно загрузить сведения об обнаружении из XML-файла вместо того, чтобы запрашивать их непосредственно из приложения WOPI.
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 |
-ProgId
Задает программный идентификатор (ProgID) для привязки приложения.
Выполните команду Get-SPWOPIBinding
, чтобы получить список идентификаторов ProgID, поддерживаемых приложением WOPI.
Этот параметр рекомендуется использовать только для связи действия с папкой OneNote.
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 |
-ServerName
Задает имя или полное доменное имя приложения WOPI (например, сервера под управлением Сервер Office Web Apps).
Это также может быть полное доменное имя конечной точки с балансировкой нагрузки для нескольких серверов Office веб-приложения.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, SharePoint Server 2016, SharePoint Server 2019 |