共用方式為

開始使用 PowerShell 資源庫

PowerShell 資源庫是一個套件儲存庫，其中包含您可以下載和利用的腳本、模組和 DSC 資源。 您可以使用 PowerShellGet 模組中的 Cmdlet，從 PowerShell 資源庫安裝套件。 您不需要登入，即可從 PowerShell 資源庫下載專案。

備註

您可以直接從 PowerShell 資源庫下載套件，但這不是建議的方法。 如需詳細資訊，請參閱 手動套件下載。

您可以使用 PowerShell 資源庫首頁上的 [搜尋] 控制項，或從 [套件] 頁面瀏覽 [模組] 和 [腳本] ，在 PowerShell 資源庫中尋找套件。 您也可以根據Find-Module套件類型-Repository PSGallery，執行 、 Find-DscResource和 Find-Script Cmdlet，從 PowerShell 資源庫尋找套件。

您可以使用下列參數篩選資源庫中的結果：

  • 名稱
  • 所有版本
  • 最小版本
  • 必要版本
  • 標記
  • 包含
  • Dsc資源
  • 角色能力
  • Command
  • Filter

如果您只想探索資源庫中的特定 DSC 資源，您可以執行 Find-DscResource Cmdlet。 Find-DscResource 會傳回資源庫中包含的 DSC 資源資料。 因為 DSC 資源一律會作為模組的一部分提供，所以您仍然需要執行才能 Install-Module 安裝這些 DSC 資源。

一旦您確定了您感興趣的套餐，您可能想了解更多信息。 您可以透過檢查該套件在資源庫上的特定頁面來執行此操作。 在該頁面上，您將能夠看到隨套件上傳的所有元資料。 此中繼資料是由套件的作者提供，而且不會由 Microsoft 驗證。 套件的擁有者與用來發佈套件的資源庫帳戶緊密相關，而且比「作者」欄位更值得信任。

如果您發現某個套件並非善意發佈，請按一下該套件頁面上的 [ 檢舉濫用行為 ]。

如果您正在執行 Find-Module 或 Find-Script，您可以在傳回的 PSGetModuleInfo 物件中檢視此資料。 下列範例會傳回資源庫中 PSReadLine 模組的資料。

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

從 PowerShell 資源庫下載套件時，我們鼓勵執行下列程式：

檢查

若要從資源庫下載套件以進行檢查，請根據套件類型執行 或 Save-ModuleSave-Script Cmdlet。 這可讓您在本機儲存套件，而不需安裝套件，並檢查套件內容。 請記得手動刪除已儲存的套件。

其中一些套件是由 Microsoft 撰寫，而其他套件則是由 PowerShell 社群撰寫。 Microsoft 建議您在安裝之前檢閱此資源庫上套件的內容和程式碼。

如果您發現某個套件並非善意發佈，請按一下該套件頁面上的 [ 檢舉濫用行為 ]。

Install

若要從資源庫安裝套件以供使用，請根據套件類型執行 或 Install-ModuleInstall-Script Cmdlet。

Install-Module 預設將模組安裝到 $env:ProgramFiles\WindowsPowerShell\Modules 。 這需要管理員帳戶。 如果您新增參數 -Scope CurrentUser ，則模組會安裝至 $HOME\Documents\WindowsPowerShell\Modules 。

Install-Script 預設會將指令碼安裝到 $env:ProgramFiles\WindowsPowerShell\Scripts 。 這需要管理員帳戶。 如果您新增參數 -Scope CurrentUser ，則指令碼會安裝至 $HOME\Documents\WindowsPowerShell\Scripts 。

預設， Install-Module 並 Install-Script 安裝套件的最新版本。 若要安裝舊版套件，請新增參數 -RequiredVersion 。

Deploy

若要將套件從 PowerShell 資源庫部署至 Azure 自動化，請按一下 [Azure 自動化]，然後按一下套件詳細資料頁面上的 [部署至 Azure 自動化 ]。 系統會將您重新導向至 Azure 管理入口網站，您可以在其中使用 Azure 帳戶認證登入。 請注意，部署具有相依性的套件會將所有相依性部署至 Azure 自動化。 您可以將 AzureAutomationNotSupported 標籤新增至套件中繼資料，以停用 [部署至 Azure 自動化] 按鈕。

若要深入瞭解 Azure 自動化，請參閱 Azure 自動化 檔。

若要更新從 PowerShell 資源庫安裝的套件，請執行 Update-Module 或 Update-Script Cmdlet。 在沒有任何額外參數的情況下執行時， Update-Module 會嘗試更新透過執行 Install-Module來安裝的所有模組。 若要選擇性地更新模組，請新增參數 -Name 。

同樣地，在沒有任何額外參數的情況下執行時， Update-Script 也會嘗試更新透過執行 Install-Script來安裝的所有指令碼。 若要選擇性地更新指令碼，請新增參數 -Name 。

若要找出您已從 PowerShell 資源庫安裝的模組，請執行 Get-InstalledModule Cmdlet。 此命令會列出系統上直接從 PowerShell 資源庫安裝的所有模組。

同樣地，若要找出您已從 PowerShell 資源庫安裝的腳本，請執行 Get-InstalledScript Cmdlet。 此命令會列出您系統上直接從 PowerShell 資源庫安裝的所有腳本。

這很重要

PowerShell 資源庫需要傳輸層安全性 （TLS） 1.2 或更新版本。 如果您未使用 TLS 1.2 或更高版本，則在嘗試存取 PowerShell 資源庫時會收到錯誤。 使用下列命令來確保您使用的是 TLS 1.2：

[Net.ServicePointManager]::SecurityProtocol =
    [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

這些主機名稱應新增至控制網路存取的允許清單。

套件探索和下載所需的主機：

  • cdn.oneget.org
  • cdn.powershellgallery.com

使用 PowerShell 資源庫網站時所需的主機：

  • *.powershellgallery.com - 網站
  • go.microsoft.com 及 aka.ms - 重定向服務

備註

這些端點已變更。 不再支援以 結尾的 azureedge.net 舊端點。

  • Last updated on