通过

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

Import-AzurePublishSettingsFile

  • 参考
模块:
Azure

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

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager （ASM） API 的旧 Azure 资源。 创建新的资源时，不建议使用此旧版 PowerShell 模块，因为 ASM 计划停用。 有关详细信息，请参阅 Azure Service Manager 停用。

Az PowerShell 模块是推荐的 PowerShell 模块，用于使用 PowerShell 管理 Azure 资源管理器 （ARM） 资源。

语法

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

类型:String
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
Accept pipeline input:False
Accept wildcard characters:False

-PublishSettingsFile

类型:String
Position:Named
默认值:None
必需:True
Accept pipeline input:True
Accept wildcard characters:False

输入

None

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

输出

None

此 cmdlet 将不生成任何输出。

备注

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