Publish-Module

模組:

PowerShellGet v3 Module

將指定的模組從本機計算機發佈至在線資源庫。

語法

ModuleNameParameterSet (預設值)

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>]

ModulePathParameterSet

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>]

Description

Publish-Module Cmdlet 會使用 API 金鑰，將模組發佈至在線 NuGet 型資源庫，並儲存為資源庫中使用者配置檔的一部分。 您可以指定要透過模組名稱或包含模組之資料夾的路徑來發佈模組。

這是 Publish-PSResource 中 Cmdlet 的 Proxy Cmdlet。 如需詳細資訊，請參閱 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

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

ModuleNameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Publish-Module之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Credential

指定有權發佈指定套件提供者或來源之模組的用戶帳戶。

參數屬性

類型:	PSCredential
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-Exclude

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ModuleNameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-FormatVersion

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	Version
預設值:	None
接受的值:	2.0
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-IconUri

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-LicenseUri

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ModuleNameParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-NuGetApiKey

指定您想要用來將模組發佈至在線資源庫的 API 金鑰。 API 金鑰是在線資源庫中設定檔的一部分，可以在資源庫的用戶帳戶頁面上找到。 API 金鑰是 NuGet 特定的功能。

Proxy Cmdlet 會將此參數對應至 的 Publish-PSResource 參數。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Path

指定您要發佈之模組的路徑。 此參數接受包含模組的資料夾路徑。 資料夾的名稱必須與模組相同。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ModulePathParameterSet

Position:	Named
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-ProjectUri

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	Uri
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ReleaseNotes

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Repository

指定已執行 Register-PSRepository所註冊之存放庫的易記名稱。 存放庫必須具有 PublishLocation，這是有效的 NuGet URI。 您可以執行 來設定 publishLocation Set-PSRepository。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-RequiredVersion

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

ModuleNameParameterSet

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SkipAutomaticTags

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Tags

Proxy Cmdlet 會忽略此參數，因為它不受 支援 Publish-PSResource。

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示 Publish-Module 執行時會發生什麼事。 指令未執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

String

PSCredential

輸出

Object

備註

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 資源庫 UI的套件指令清單值。

相關連結

• Find-Module
• Install-Module
• Register-PSRepository
• Set-PSRepository
• Uninstall-Module
• Update-Module