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

Начало работы с коллекцией PowerShell

Галерея PowerShell — это хранилище пакетов, содержащее скрипты, модули и ресурсы DSC, которые вы можете скачать и использовать. Командлеты в модуле PowerShellGet используются для установки пакетов из коллекции PowerShell. Вам не нужно входить в систему, чтобы скачать элементы из коллекции PowerShell.

Пакеты можно найти в коллекции PowerShell с помощью элемента управления поиска на домашнейстранице коллекции PowerShell или на странице пакетов. Вы также можете найти пакеты из коллекции PowerShell, выполнив Find-Module, Find-DscResourceи Find-Script командлеты в зависимости от типа пакета с -Repository PSGallery.

Результаты из коллекции можно фильтровать с помощью следующих параметров:

  • Имя
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Ярлык
  • Включает
  • DscResource
  • RoleCapability
  • Команда
  • Фильтр

Если вы заинтересованы только в обнаружении определенных ресурсов DSC в коллекции, можно запустить командлет Find-DscResource. Find-DscResource возвращает данные о ресурсах DSC, содержащихся в коллекции. Так как ресурсы DSC всегда предоставляются в рамках модуля, вам по-прежнему необходимо запустить Install-Module для установки этих ресурсов DSC.

После выбора пакета вам стоит узнать о нём больше. Ознакомьтесь со страницей упаковки в Галерее. Страница пакета содержит метаданные, загруженные вместе с пакетом. Метаданные предоставляются автором пакета. Microsoft не проверяет эту информацию. Владелец пакета связан с аккаунтом Gallery, используемым для публикации пакета. Аккаунт Owner более авторитетен, чем поле Author.

Если вы обнаружили пакет, который, по вашему мнению, не опубликован добросовестно, выберите «Сообщить о злоупотреблении » на странице этого пакета.

Если вы используете 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 location, для чего требуется учетная запись администратора. Если добавить -Scope CurrentUser параметр, команда устанавливает скрипт в $HOME\Documents\WindowsPowerShell\Scripts.

Install-Module и Install-Script устанавливает самую актуальную версию пакета. Чтобы установить старую версию пакета, добавьте параметр -RequiredVersion.

Развертывать

Чтобы развернуть пакет из галереи PowerShell в Azure Automation, выберите Azure Automation, затем выберите Deploy to Azure Automation на странице деталей пакета. Вас перенаправляют на портал управления Azure, где вы входите с учётными данными учетной записи Azure. Развертывание пакетов с зависимостями развёртает все зависимости в Azure Automation. Кнопку Deploy to Azure Automation можно отключить, добавив тег AzureAutomationNotSupported в метаданные вашего пакета.

Дополнительные сведения об службе автоматизации Azure см. в документации по службы автоматизации Azure .

Чтобы обновить пакеты, установленные из коллекции PowerShell, запустите командлет Update-Module или Update-Script. При запуске без каких-либо других параметров Update-Module пытается обновить все установленные модули, запустив Install-Module. Чтобы выборочно обновить модули, добавьте параметр -Name.

Аналогично, при запуске без каких-либо других параметров пытается Update-Script обновить все установленные скрипты, запустив Install-Script. Чтобы выборочно обновить скрипты, добавьте параметр -Name.

Чтобы узнать, какие модули вы установили из галереи PowerShell, запустите cmdlet Get-InstalledModule . Эта команда содержит список всех модулей, которые были установлены непосредственно из коллекции 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