共用方式為

Get-AzurePublishSettingsFile

  • 參考
模組:
Azure

下載 Azure 訂用帳戶的發佈配置檔。

注意

本文件中參考的 Cmdlet 用於管理使用 Azure Service Manager（ASM） API 的舊版 Azure 資源。 建立新的資源時，不建議使用此舊版 PowerShell 模組，因為 ASM 已排定淘汰。 如需詳細資訊，請參閱 Azure Service Manager 淘汰。

Az PowerShell 模組是使用 PowerShell 管理 Azure Resource Manager （ARM） 資源的建議 PowerShell 模組。

語法

Get-AzurePublishSettingsFile
   [-Environment <String>]
   [-Realm <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Get-AzurePublishSettingsFile Cmdlet 會在您的帳戶中下載訂用帳戶的發佈配置檔。 當命令完成時，您可以使用 Import-PublishSettingsFile Cmdlet，讓檔案中的設定可供 Windows PowerShell 使用。

若要讓您的 Azure 帳戶可供 Windows PowerShell 使用，您可以使用發佈配置檔或 Add-AzureAccount Cmdlet。 發佈設定檔可讓您事先準備會話，以便自動執行腳本和背景工作。 不過，並非所有服務都支援發佈配置檔。 例如， AzureResourceManager 模組不支援發佈配置檔。

當您執行 Get-AzurePublishSettingsFile 時，它會開啟您的預設瀏覽器，並提示您登入 Azure 帳戶、選取訂用帳戶，然後選取發佈配置檔的文件系統位置。 然後，它會將訂用帳戶的發佈配置檔下載到您選取的檔案中。

「發佈配置檔」是擴展名為 .publishsettings 的 XML 檔案。 檔案包含編碼的憑證，可提供 Azure 訂用帳戶的管理認證。

安全性注意事項： 發佈配置檔包含用來管理 Azure 訂用帳戶和服務的認證。 如果惡意使用者存取您的發佈配置檔，他們可以編輯、建立和刪除您的 Azure 服務。 基於安全性最佳作法，請將檔案儲存到 [下載] 或 [檔] 資料夾中的位置，然後使用 Import-AzurePublishSettingsFile Cmdlet 來匯入設定之後加以刪除。

本主題描述 Microsoft Azure PowerShell 模組 0.8.10 版本中的 Cmdlet。 若要取得您所使用的模組版本，請在 Azure PowerShell 控制台中輸入 (Get-Module -Name Azure).Version。

範例

範例 1：下載發佈配置檔

PS C:\> Get-AzurePublishSettingsFile

此命令會開啟您的默認瀏覽器、連線到您的 Windows Azure 帳戶，然後下載您帳戶的 .publishsettings 檔案。

範例 2：指定領域

PS C:\> Get-AzurePublishSettingsFile -Realm contoso.com -Passthru

此命令會下載 contoso.com 網域中帳戶的發佈配置檔。 當您使用組織帳戶登入 Azure 時，請搭配 Realm 參數使用命令，而不是使用 Microsoft 帳戶。

參數

-Environment

指定 Azure 環境。

Azure 環境是獨立部署Microsoft Azure，例如適用於全球 Azure 的 Azure 雲端，以及由中國 21Vianet 營運的 AzureChinaCloud。 您也可以使用 Azure Pack 和 WAPack Cmdlet 來建立內部部署 Azure 環境。 如需詳細資訊，請參閱 Azure Pack。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-PassThru

如果命令成功，並$False失敗，則傳回$True。 根據預設，此 Cmdlet 不會傳回任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Profile

指定此 Cmdlet 從中讀取的 Azure 設定檔。 如果您未指定設定檔，此 Cmdlet 會從本機預設配置檔讀取。

類型:AzureSMProfile
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Realm

指定組織標識碼中的組織。 例如，如果您以 身分admin@contoso.com登入 Azure，則 Realm 參數的值會 contoso.com。 當您使用組織識別碼登入 Azure 入口網站 時，請使用此參數。 當您使用Microsoft帳戶時，不需要此參數，例如 outlook.com 或 live.com 帳戶。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

輸入

None

您可以透過屬性名稱將輸入管線傳送至此 Cmdlet，但不能依值傳送。

輸出

None or System.Boolean

當您使用 PassThru 參數時，這個 Cmdlet 會傳回布爾值。 否則，此 Cmdlet 不會傳回任何輸出