次の方法で共有

PowerShell ギャラリーの概要

PowerShellギャラリーは、スクリプト、モジュール、DSCリソースをダウンロードして利用できるパッケージリポジトリです。 PowerShell ギャラリーからパッケージをインストールするには、PowerShellGet モジュールのコマンドレットを使用します。 PowerShell ギャラリーからアイテムをダウンロードするためにサインインする必要はありません。

PowerShell ギャラリーでパッケージを見つけるには、PowerShell ギャラリーの ホーム ページの Search コントロールを使用するか、パッケージ ページからモジュールとスクリプトを参照します。 パッケージの種類に応じて、Find-Module、Find-DscResource、および Find-Script コマンドレットを実行して、-Repository PSGalleryを使用して PowerShell ギャラリーからパッケージを検索することもできます。

次のパラメーターを使用して、ギャラリーからの結果をフィルター処理できます。

  • 名前
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • タグ
  • 含む
  • DscResource
  • RoleCapability
  • 命令
  • フィルター

ギャラリー内の特定の DSC リソースの検出のみに関心がある場合は、Find-DscResource コマンドレットを実行できます。 Find-DscResource は、ギャラリーに含まれる DSC リソースのデータを返します。 DSC リソースは常にモジュールの一部として配信されるため、これらの DSC リソースをインストールするには Install-Module を実行する必要があります。

パッケージを選んだら、その内容についてもっと知りたいかもしれません。 ギャラリーのパッケージページをご覧ください。 パッケージページにはパッケージにアップロードされたメタデータが含まれています。 メタデータはパッケージの作者によって提供されています。 Microsoftはこの情報を検証していません。 パッケージの所有者は、パッケージを公開するために使われるギャラリーアカウントに関連付けられています。 オーナーアカウントの方が著者欄よりも権威があります。

善意で公開されていないと感じるパッケージを見つけたら、そのパッケージのページで「 悪用を報告 」を選択してください。

Find-Module または Find-Scriptを実行している場合は、返された PSGetModuleInfo オブジェクトでこのデータを表示できます。 次の例では、ギャラリー内の PSReadLine モジュールのデータを返します。

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

PowerShell ギャラリーからパッケージをダウンロードするときは、次のプロセスをお勧めします。

検査する

ギャラリーからパッケージをダウンロードして検査するには、パッケージの Save-Module または Save-Script コマンドレットを使います。 これらのコマンドはパッケージをインストールせずにローカルで保存します。 荷物の中身を調べてください。 保存したパッケージは必ず手動で削除してください。

一部のパッケージはMicrosoftによって作成され、他はPowerShellコミュニティによって作成されています。 インストールする前に、このギャラリーのパッケージの内容とコードを確認することをお勧めします。

善意で公開されていないと感じるパッケージを見つけたら、そのパッケージのページで「 悪用を報告 」を選択してください。

取り付ける

使用するためにギャラリーからパッケージをインストールするには、パッケージの種類に応じて、Install-Module または Install-Script コマンドレットを実行します。

デフォルトでは 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 パラメーターを追加します。

展開

PowerShellギャラリーからAzure Automationにパッケージをデプロイするには、 Azure Automationを選択し、パッケージ詳細ページで「 Deploy to Azure Automation 」を選択してください。 Azureアカウントの認証情報でサインインするため、Azure管理ポータルにリダイレクトされます。 依存関係のあるパッケージをデプロイすると、すべての依存関係がAzure Automationにデプロイされます。 Azure への自動化展開 ボタンは、パッケージのメタデータに AzureAutomationNotSupported タグを追加することで無効化できます。

Azure Automation の詳細については、Azure Automation ドキュメント 参照してください。

PowerShell ギャラリーからインストールされているパッケージを更新するには、Update-Module または Update-Script コマンドレットを実行します。 他のパラメータなしで実行した場合、Update-ModuleInstall-Moduleを実行することでインストールされたすべてのモジュールを更新しようとします。 モジュールを選択的に更新するには、-Name パラメーターを追加します。

同様に、他のパラメータなしで実行された場合、Update-ScriptInstall-Scriptを実行することでインストールされたすべてのスクリプトの更新を試みます。 スクリプトを選択的に更新するには、-Name パラメーターを追加します。

PowerShellギャラリーからインストールしたモジュールを調べるには、 Get-InstalledModule コマンドレットを実行してください。 このコマンドは、PowerShell ギャラリーから直接インストールされたシステム上にあるすべてのモジュールを一覧表示します。

同様に、PowerShellギャラリーからインストールしたスクリプトを調べるには、 Get-InstalledScript コマンドレットを実行してください。 このコマンドは、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 ギャラリー Web サイトを使用する場合に必要なホスト:

  • *.powershellgallery.com - Web サイト
  • go.microsoft.com と aka.ms - リダイレクト サービス

手記

azureedge.netで終わった古いエンドポイントはサポートされなくなりました。

  • Last updated on