使用 Windows PowerShell 管理 SharePoint 2010 產品

  • 發行項

 

適用版本： SharePoint Foundation 2010

上次修改主題的時間： 2017-01-18

本文說明如何搭配 Microsoft SharePoint 2010 產品 使用 Windows PowerShell，並提供 Windows PowerShell Cmdlet 的基本概觀以及從此強大功能獲益所需的概念。

本文內容：

  • 概觀

  • 使用 SharePoint 2010 管理命令介面存取 Windows PowerShell for SharePoint 2010 產品

  • 權限

  • 指令碼和執行原則

  • 瞭解 Windows PowerShell

概觀

Windows PowerShell 為命令列指令碼工具，不僅可對管理員提供適當之應用程式開發介面 (API) 的完整存取權，還能讓管理員直接與 SharePoint 2010 產品 產品互動，操作 Web 應用程式、網站集合、網站、清單等。此外，管理員甚至可以撰寫 Cmdlet (發音為 "command-lets") 指令碼，改善舊版產品的使用經驗。

Windows PowerShell 2.0 是安裝 SharePoint 2010 產品 的必要軟體。此程式將會視需要在您執行 Microsoft SharePoint 產品準備工具 時安裝。Windows PowerShell 預設位於下列路徑：<%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe。

注意

Windows PowerShell 2.0 可與舊版 Windows PowerShell 1.0 相容，因此稍後會安裝至 v1.0 資料夾。

如需 Windows PowerShell 2.0 版的新增功能清單，請參閱關於 Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x404)。

如需協助您了解 Windows PowerShell 語法的互動式工具和指南，請參閱 Windows PowerShell 命令建立工具 (可能為英文網頁)和快速入門指南 (可能為英文網頁)。

建議您在執行命令列管理工作時使用 Windows PowerShell。Stsadm 命令列工具已過時，但為與舊版產品相容，仍會隨附提供。

存取 SharePoint 2010 產品的 Windows PowerShell

安裝 SharePoint 2010 產品之後，即可使用 SharePoint 2010 管理命令介面或使用 Windows PowerShell 主控台，來使用適用的 Windows PowerShell Cmdlet。您可以使用管理命令介面來管理 SharePoint 2010 產品 的各個層面。您可以建立新的網站集合、Web 應用程式、使用者帳戶、服務應用程式、Proxy 等等。管理命令介面發出的命令會以 Microsoft .NET 平台為基礎來輸出 SharePoint 物件。這些物件可以視為後續命令的輸入，或儲存於本機變數內以供稍後使用。

使用管理命令介面，您就不必登錄包含 Cmdlet 的嵌入式管理單元。位於 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration 中的 SharePoint.ps1 檔案，其中的 Add-PSSnapin Microsoft.SharePoint.PowerShell 一行會自動登錄 SharePoint 2010 Cmdlet 的 Microsoft.SharePoint.PowerShell.dll 模組。如果您選擇要使用 Windows PowerShell 主控台，您就必須手動登錄此嵌入式管理單元。

不論您使用管理命令介面或 Windows PowerShell 主控台，您都可以載入其他嵌入式管理單元。如需詳細資訊，請參閱自訂設定檔 (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x404)。

存取 SharePoint 2010 管理命令介面

  1. 在 [開始] 功能表上，按一下 [所有程式]。

  2. 按一下 [Microsoft SharePoint 2010 產品]。

  3. 按一下 [SharePoint 2010 管理命令介面]。

注意

SharePoint 2010 管理命令介面與 Windows PowerShell 主控台使用 ReuseThread 選項的方式也不相同，此選項可定義使用執行緒模式的方式。SharePoint.ps1 檔案中的此行 {Host.Runspace.ThreadOptions = "ReuseThread"} 定義了使用管理命令介面的用法。如需詳細資訊，請參閱 PS 執行緒選項(可能為英文網頁) (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x404)(可能為英文網頁)。

權限

使用管理命令介面與 Windows PowerShell Cmdlet 之前，請確認符合下列基本需求：請參閱＜Add-SPShellAdmin＞。

如果您不具 SharePoint_Shell_Access 角色或 WSS_Admin_WPG 本機群組的成員資格，請使用 Add-SPShellAdmin Cmdlet。使用 Add-SPShellAdmin Cmdlet 時，會將使用者新增至前端網頁伺服器中的 WSS_Admin_WPG 群組，還會新增至 SharePoint_Shell_Access 角色。如果目標資料庫沒有 SharePoint_Shell_Access 角色，系統會自動建立此角色。執行 Add-SPShellAdmin Cmdlet 之後，使用者就可以在多個伺服器陣列環境中執行 SharePoint 2010 Windows PowerShell Cmdlet。

若您執行 Add-SPShellAdmin Cmdlet 將使用者新增至 SharePoint_Shell_Access 角色，您就必須具備下列安全性權限：

  • SQL 執行個體的 Securityadmin 伺服器角色存取權，以及資料庫的 db_owner 角色

  • 本機電腦的管理權限

注意

通常，將要使用 Add-SPShellAdmin Cmdlet 的人員必須與用來進行安裝的使用者帳戶相關聯。

您必須對所有要授與存取權的資料庫執行 Add-SPShellAdmin Cmdlet。如果未指定資料庫，就會使用伺服器陣列設定資料庫。如果有指定資料庫，除了您指定的伺服器陣列設定資料庫之外，還會包括伺服器陣列內容資料庫。

若要查看全部的 *SPShellAdmin Cmdlet 清單，請在 Windows PowerShell 命令提示字元中，輸入 Get-Command -Noun SPShellAdmin。

指令碼和執行原則

雖然您可以使用 Windows PowerShell 執行單一管理工作，但是使用 Windows PowerShell Cmdlet 的真正好處是可以使用指令碼來自動化一系列的工作。指令碼是含有一個或多個 Windows PowerShell 命令的純文字檔。Windows PowerShell 指令碼的副檔名是 .ps1。

使用指令碼時，請注意 SharePoint 2010 產品 的最小必要執行原則是 RemoteSigned，而 Windows PowerShell 的預設原則是 Restricted。如果原則保留為 Restricted，則 SharePoint 2010 管理命令介面會將 Windows PowerShell 的原則變更為 RemoteSigned。這表示必須選取 [以系統管理員身分執行]，使用提高管理權限來啟動 SharePoint 2010 管理命令介面。這項變更會套用至所有 Windows PowerShell 工作階段。

如需指令碼和執行原則的詳細資訊，請分別參閱 about_scripts 和 about_Execution_Policies。

瞭解 Windows PowerShell

不熟悉 Windows PowerShell 的 SharePoint IT 人員有數種 Windows PowerShell 學習資源可以使用。

TechNet 指令碼中心

TechNet 指令碼中心內含許多可讓您學習使用 Windows PowerShell 基本技巧的資源。其中包含的指令碼存放庫提供可搭配各種不同 Microsoft 產品的常用指令碼範例。下表顯示主要的學習資源。

頁面 描述

TechNet 上的 Windows PowerShell 文件 (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x404)

此部分的 TechNet Library 包含核心 Windows PowerShell Get-Help 主題的網頁。此部分也內含 Windows PowerShell 快速入門文件、PowerShell.exe 說明以及 Windows PowerShell 入門的網頁。

使用 Windows PowerShell 撰寫指令碼 (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x404)

Windows PowerShell 指令碼撰寫學習資源的首頁。

Windows PowerShell 擁有人手冊(可能為英文網頁) (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x404)(可能為英文網頁)

Windows PowerShell 快速入門的網頁指南。

Windows PowerShell 快速參考 (可能為英文網頁) (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x404)(可能為英文網頁)

可下載的快速參考文件，可隨 Windows PowerShell 一起安裝。

Windows PowerShell 文件

Windows PowerShell 會在 Windows PowerShell 1.0 程式群組中安裝下列文件。您也可以於下載 Windows PowerShell 1.0 文件套件(可能為英文網頁) (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x404)(可能為英文網頁) 之後再安裝這些文件。

檔案 描述

GettingStarted.rtf

說明如何開始使用 Windows PowerShell。

UsersGuide.rtf

Windows PowerShell 環境及語言入門。

QuadFold.rtf

常用 Windows PowerShell 語法及命令的可列印快速參考文件。您也可以從 TechNet 指令碼中心下載此文件。

閱讀這些資源時，請將下列概念與 Cmdlet 視為使用 SharePoint 2010 產品前必須事先暸解的實用資訊：