New-SPWOPIBinding
在目前執行此 Cmdlet 的 SharePoint 伺服器陣列上,建立新繫結以將副檔名或應用程式關聯至動作。
Syntax
New-SPWOPIBinding
-ServerName <String>
[-Action <String>]
[-AllowHTTP]
[-Application <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Extension <String>]
[-FileName <String>]
[-ProgId <String>]
[-WhatIf]
[<CommonParameters>]
Description
此 New-SPWOPIBinding
Cmdlet 會將副檔名或應用程式關聯至目前執行此 Cmdlet 之 SharePoint 伺服器陣列上的動作。
每個系結都可讓您使用 WOPI 應用程式來檢視或編輯 SharePoint 文件庫中的檔案。
例如,當使用者在 SharePoint 檔案清單中看到 Word 檔時,SharePoint 清單會根據系結至該 SharePoint 伺服器陣列上 Word 的動作,顯示可檢視或編輯檔的可用選項。
若要使用 WOPI 應用程式,例如執行 Office Web Apps Server 的伺服器,針對 Office Web Apps,您必須在 SharePoint 伺服器陣列上執行此 Cmdlet,才能使用 Office Web Apps。
如果您 New-SPWOPIBinding
針對系結 (或關聯) 已存在的應用程式或副檔名執行 ,Cmdlet 將會失敗。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
------------------範例 1-----------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com"
此範例會在目前執行此 Cmdlet 的 SharePoint 伺服器陣列上,建立 WOPI 應用程式支援之所有應用程式與副檔名的繫結。
------------------範例 2-----------------------
New-SPWOPIBinding -ServerName "Server.corp.Contoso.com" -Application "Excel"
此範例會在目前執行此 Cmdlet 的 SharePoint 伺服器陣列上,將 Excel 關聯至 WOPI 應用程式支援 Excel 的所有動作。
參數
-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
指定此 Cmdlet 可以使用 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
指定包含 WOPI 應用程式之探索資訊的 xml 檔案路徑。
您可以從 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
以取得 WOPI 應用程式支援的 ProgID 清單。
您可能只想使用此參數將動作關聯至 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 Server 的伺服器) 的名稱或完整網域名稱 (FQDN)。
這也可以是多個 Office Web Apps 伺服器之負載平衡端點的 FQDN。
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 |