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


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