Publish-Module
Публикует указанный модуль с локального компьютера в онлайн-коллекции.
Синтаксис
Publish-Module
-Name <String>
[-RequiredVersion <String>]
[-NuGetApiKey <String>]
[-Repository <String>]
[-Credential <PSCredential>]
[-FormatVersion <Version>]
[-ReleaseNotes <String[]>]
[-Tags <String[]>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ProjectUri <Uri>]
[-Exclude <String[]>]
[-Force]
[-AllowPrerelease]
[-SkipAutomaticTags]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Publish-Module
-Path <String>
[-NuGetApiKey <String>]
[-Repository <String>]
[-Credential <PSCredential>]
[-FormatVersion <Version>]
[-ReleaseNotes <String[]>]
[-Tags <String[]>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ProjectUri <Uri>]
[-Force]
[-SkipAutomaticTags]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Описание
Командлет Publish-Module публикует модуль в онлайн-коллекции NuGet с помощью ключа API, хранящегося в составе профиля пользователя в коллекции. Можно указать модуль для публикации по имени модуля или по пути к папке, содержащей модуль.
Это командлет прокси-сервера для командлета Publish-PSResource в Microsoft.PowerShell.PSResourceGet. Дополнительные сведения см. в статье Publish-PSResource.
Примеры
Пример 1. Публикация модуля
В этом примере MyDscModule публикуется в онлайн-коллекции с помощью ключа API, чтобы указать учетную запись веб-коллекции владельца модуля. Если MyDscModule не является допустимым модулем манифеста, указывающим имя, версию, описание и автор, возникает ошибка.
Publish-Module -Path c:\projects\MyDscModule\1.0.0 -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73"Пример 2. Публикация модуля с метаданными коллекции
В этом примере MyDscModule публикуется в онлайн-коллекции с помощью ключа API для указания учетной записи владельца коллекции модуля. Дополнительные метаданные отображаются на веб-странице модуля в коллекции. Владелец добавляет два тега поиска для модуля, связанные с Active Directory; Добавляется краткое примечание о выпуске. Если MyDscModule не является допустимым модулем манифеста, указывающим имя, версию, описание и автор, возникает ошибка.
$parameters = @{
Path = 'c:\projects\MyDscModule\1.0.0'
NuGetApiKey = '11e4b435-6cb4-4bf7-8611-5162ed75eb73'
LicenseUri = 'http://contoso.com/license'
Tag = 'Active Directory','DSC'
ReleaseNote = 'Updated the ActiveDirectory DSC Resources to support adding users.'
}
Publish-Module @parametersПараметры
-AllowPrerelease
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Запрашивает подтверждение перед запуском Publish-Module.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Credential
Указывает учетную запись пользователя, которая имеет права на публикацию модуля для указанного поставщика пакетов или источника.
| Тип: | PSCredential |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-Exclude
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Force
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-FormatVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | Version |
| Допустимые значения: | 2.0 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IconUri
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | Uri |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-LicenseUri
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | Uri |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-NuGetApiKey
Указывает ключ API, который требуется использовать для публикации модуля в коллекции в сети. Ключ API является частью профиля в коллекции в сети, и его можно найти на странице учетной записи пользователя в коллекции. Ключ API — это функциональные возможности NuGet.
Командлет прокси-сервера сопоставляет этот параметр с параметром Publish-PSResourceApiKey.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Path
Указывает путь к модулю, который требуется опубликовать. Этот параметр принимает путь к папке, содержащей модуль. Папка должна иметь то же имя, что и модуль.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-ProjectUri
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | Uri |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ReleaseNotes
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Repository
Указывает понятное имя репозитория, зарегистрированного с помощью запуска Register-PSRepository. Репозиторий должен иметь значение PublishLocation, которое является допустимым универсальным кодом ресурса (URI) NuGet.
Параметр PublishLocation можно задать, выполнив команду Set-PSRepository.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-RequiredVersion
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-SkipAutomaticTags
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Tags
Командлет прокси-сервера игнорирует этот параметр, так как он не поддерживается Publish-PSResource.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если запустится Publish-Module. Командлет не запускается.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Выходные данные
Примечания
PowerShell включает следующие псевдонимы для Publish-Module:
- Все платформы:
pumo
Publish-Module выполняется в powerShell 3.0 или более поздних выпусках PowerShell в Windows 7 или Windows 2008 R2 и более поздних выпусках Windows.
Коллекция PowerShell больше не поддерживает протокол TLS версии 1.0 и 1.1. Необходимо использовать TLS 1.2 или более поздней версии. Используйте следующую команду, чтобы убедиться, что используется TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Для публикации модуля требуются метаданные, отображаемые на странице коллекции для модуля. Обязательные метаданные включают имя модуля, версию, описание и автор. Метаданные должны быть определены в манифесте модуля. Дополнительные сведения см. в разделе "Значения манифеста пакета", влияющие на пользовательский интерфейс коллекции PowerShell.
Связанные ссылки
PSResourceGet