Announcement
Это репо устарело. Модуль PackageManagementProviderResource был объединен с PackageManagement. Пожалуйста, используйте https://github.com/OneGet/oneget в дальнейшем. Спасибо!
PackageManagementProviderResource — это ресурсы DSC для поставщиков PackageManagement (также известных как OneGet). В настоящее время он содержит ресурсы DSC поставщика Nuget и PowerShellGet, позволяющие управлять пакетами и модулями Windows PowerShell.
Пожалуйста, ознакомьтесь с общими рекомендациями по участию в ресурсах DSC.
PackageManagement — универсальный поставщик PackageManagement, который позволяет загружать и устанавливать пакеты из любого источника. Этот поставщик использует командлеты Install-Package и Get-Package. Возможно, вам придется использовать ресурс PackageManagementSource DSC для регистрации источников, не используемых по умолчанию.
NugetPackage — позволяет загружать пакеты из исходного местоположения NuGet (например, http://nuget.org/api/v2/), а также устанавливать или удалять пакет.
PSModule — позволяет загружать модули Windows PowerShell из галереи PowerShell «PSGallery» (например, https://www.powershellgallery.com/api/v2/) и устанавливать их на свой компьютер.
PackageManagementSource — позволяет зарегистрировать или отменить регистрацию источника пакета на вашем компьютере.
Ресурс PackageManagement DSC имеет следующие свойства:
Свойство | Описание |
Имя | Указывает имя пакета, который необходимо установить или удалить. |
Источник | Указывает имя источника пакета, в котором можно найти пакет. Это может быть либо URI, либо источник, зарегистрированный с помощью командлета Register-PackageSource или ресурса PackageManagementSource DSC. Ресурс DSC MSFT_PackageManagementSource также может зарегистрировать источник пакета. |
Гарантировать | Определяет, будет ли пакет установлен или удален. |
Требуемая версия | Указывает точную версию пакета, который вы хотите установить. Если вы не укажете этот параметр, этот ресурс DSC установит новейшую доступную версию пакета, которая также соответствует любой максимальной версии, указанной параметром MaximumVersion. |
Минимальная версия | Указывает минимально допустимую версию пакета, который вы хотите установить. Если вы не добавите этот параметр, этот ресурс DSC будет содержать самую высокую доступную версию пакета, которая также удовлетворяет любой максимальной указанной версии, указанной параметром MaximumVersion. |
Максимальная версия | Указывает максимально разрешенную версию пакета, который вы хотите установить. Если вы не укажете этот параметр, этот ресурс DSC установит доступную версию пакета с наибольшим номером. |
ИсточникCredential | Указывает учетную запись пользователя, имеющую права на установку пакета для указанного поставщика пакетов или источника. |
ИмяПоставщика | Указывает имя поставщика пакетов, в пределах которого будет выполняться поиск пакетов. Имена поставщиков пакетов можно получить, выполнив командлет Get-PackageProvider. |
Дополнительные параметры | Параметры, специфичные для поставщика, которые передаются в виде хэш-таблицы. Например, для поставщика NuGet вы можете передать дополнительные параметры, такие как DestinationPath. |
Ресурс NugetPackage DSC имеет следующие свойства:
Свойство | Описание |
Имя | Указывает имя пакета, который необходимо установить или удалить. |
Путь назначения | Указывает расположение файла, в который вы хотите установить пакет. |
Гарантировать | Определяет, будет ли пакет установлен или удален. |
Политика установки | Определяет, доверяете ли вы источнику пакета. |
Требуемая версия | Указывает точную версию пакета, который вы хотите установить или удалить. |
Минимальная версия | Указывает минимальную версию пакета, который вы хотите установить или удалить. |
Максимальная версия | Указывает максимальную версию пакета, который вы хотите установить или удалить. |
Источник | Указывает URI или имя зарегистрированного источника пакета. |
ИсточникCredential | Предоставляет доступ к пакету в удаленном источнике. Это свойство не используется для установки пакета. Пакет всегда устанавливается под учетной записью локальной системы. |
Ресурс PSModule DSC имеет следующие свойства:
Свойство | Описание |
Имя | Указывает имя модуля PowerShell, который необходимо установить или удалить. |
Гарантировать | Определяет, будет ли модуль установлен или удален. |
Политика установки | Определяет, доверяете ли вы исходному репозиторию, в котором находится модуль. |
Требуемая версия | Указывает точную версию модуля, который вы хотите установить или удалить. |
Минимальная версия | Указывает минимальную версию модуля, который вы хотите установить или удалить. |
Репозиторий | Указывает имя репозитория исходного кода модуля, в котором можно найти модуль. |
PackageManagementSource имеет следующие свойства:
Свойство | Описание |
Имя | Указывает имя источника пакета, который необходимо зарегистрировать или отменить регистрацию в вашей системе. |
ИмяПоставщика | Указывает имя поставщика OneGet, через который можно взаимодействовать с источником пакета. |
Гарантировать | Определяет, должен ли источник пакета быть зарегистрированным или незарегистрированным. |
Политика установки | Определяет, доверяете ли вы источнику пакета. |
SourceUri | Указывает URI источника пакета. |
ИсточникCredential | Предоставляет доступ к пакету в удаленном источнике. |
Перед установкой этого пакета необходимо запустить [Windows Management Framework 5.0 RTM (https://www.microsoft.com/en-us/download/details.aspx?id=50395).
Чтобы использовать модуль PackageManagementProviderResource ,
Чтобы подтвердить установку,
Код представляет собой сценарий Windows PowerShell и интерпретируется механизмом Windows PowerShell во время выполнения.
Чтобы протестировать модули, выполните следующие команды. Ресурс NuGetPackage используется здесь в качестве примера.
Вы можете повторить эти команды аналогичным образом для тестирования ресурсов PackageManagement, PSModule и PackageManagementSource DSC.
Вы можете внести свой вклад в этот проект. Есть много способов внести свой вклад:
Отправьте отчет об ошибке через «Проблемы». Руководство по отправке хороших отчетов об ошибках можно найти в статье «Безболезненное отслеживание ошибок».
Проверьте исправления ошибок.
Отправьте исправление ошибки. Перед отправкой убедитесь, что у вас есть:
Вы также можете прочитать эти две статьи в блоге о внесении кода: «Этикет вклада в открытый исходный код» Мигеля де Икасы и «Не «нажимайте» на запросы на включение» Ильи Григорика.
Прежде чем отправлять новую функцию или существенный вклад в код, обсудите ее с командой Windows PowerShell в разделе «Проблемы» и убедитесь, что она соответствует плану развития продукта. Обратите внимание, что все отправленные коды будут тщательно проверены командой Windows PowerShell. В исходный код будут добавлены только те проекты, которые соответствуют высоким требованиям как по качеству, так и по соответствию дорожной карте.
#### Примеры ####
Образцы включены в папку «Примеры».