你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Import-AzurePublishSettingsFile

  • 参考
模块:
Azure

导入可让你在 Windows PowerShell 中管理 Azure 帐户的发布设置文件。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。 若要了解用于管理 Azure 资源管理器资源的 cmdlet，请参阅 Az PowerShell 模块。

语法

Import-AzurePublishSettingsFile
      -PublishSettingsFile <String>
      [-Environment <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

说明

Import-AzurePublishSettingsFile cmdlet 导入一个发布设置文件（*.publishsettings），该文件包含有关 Azure 帐户的信息，并将订阅数据文件保存在计算机上。 cmdlet 完成后，可以在 Windows PowerShell 中管理 Azure 帐户。

在运行 Import-AzurePublishSettingsFile 之前，请运行 Get-AzurePublishSettingsFile，这将下载并保存发布设置文件，以便导入它。

若要使 Azure 帐户可用于 Windows PowerShell，可以使用发布设置文件或 Add-AzureAccount cmdlet。 通过发布设置文件，可以提前准备会话，以便可以无人参与地运行脚本和后台作业。 但是，并非所有服务都支持发布设置文件。 例如， AzureResourceManager 模块不支持发布设置文件。

安全说明： 发布设置文件包含已编码但未加密的管理证书。 如果恶意用户访问发布设置文件，他们可能能够编辑、创建和删除 Azure 服务。 最佳做法是，将文件保存到“下载”或“文档”文件夹中的位置，然后使用 Import-AzurePublishSettingsFile cmdlet 导入设置后将其删除。

示例

示例 1：导入文件

PS C:\> Import-AzurePublishSettingsFile -PublishSettingsFile C:\Temp\MyAccount.publishsettings

此命令导入“C：\Temp\MyAccount.publishsettings”文件。

参数

-Environment

指定 Azure 环境。

Azure 环境是 Microsoft Azure 的独立部署，例如 AzureCloud for global Azure，以及由世纪互联在中国运营的 AzureChinaCloud for Azure。 还可以使用 Azure Pack 和 WAPack cmdlet 创建本地 Azure 环境。 有关详细信息，请参阅 Azure Pack。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。 如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFile

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

None

可以通过属性名称（而不是值）通过管道将输入传递给此 cmdlet。

输出

None

此 cmdlet 不生成任何输出。

备注

  • “发布设置文件”是扩展名为 .publishsettings 的 XML 文件。 该文件包含一个编码的证书，该证书为 Azure 订阅提供管理凭据。 导入此文件后，请将其删除以避免安全风险。
  • “订阅数据文件”是可以安全地在计算机上保存的 XML 文件。 默认情况下，它保存在漫游用户配置文件（$home/AppData/Roaming） 中。