Share via

Import-AzurePublishSettingsFile

  • リファレンス
モジュール:
Azure

Windows PowerShell で Azure アカウントを管理できる発行設定ファイルをインポートします。

注意

このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。

構文

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

説明

Import-AzurePublishSettingsFile コマンドレットは、Azure アカウントに関する情報を含む発行設定ファイル (*.publishsettings) をインポートし、サブスクリプション データ ファイルをコンピューターに保存します。 コマンドレットが完了したら、Windows PowerShell で Azure アカウントを管理できます。

Import-AzurePublishSettingsFile を実行する前に、Get-AzurePublishSettingsFile を実行します。このファイルは、発行設定ファイルをダウンロードして保存してインポートできます。

Windows PowerShell で Azure アカウントを使用できるようにするには、発行設定ファイルまたは Add-AzureAccount コマンドレットを使用します。 設定ファイルを発行すると、スクリプトとバックグラウンド ジョブを無人で実行できるように、セッションを事前に準備できます。 ただし、すべてのサービスが設定ファイルの発行をサポートしているわけではありません。 たとえば、 AzureResourceManager モジュールでは、設定ファイルの発行はサポートされていません。

セキュリティ上の注意: 発行設定ファイルには、エンコードされているが暗号化されていない管理証明書が含まれています。 悪意のあるユーザーが発行設定ファイルにアクセスすると、Azure サービスを編集、作成、削除できる可能性があります。 セキュリティのベスト プラクティスとして、ファイルをダウンロードフォルダーまたはドキュメント フォルダー内の場所に保存し、Import-AzurePublishSettingsFile コマンドレットを使用して設定をインポートした後で削除します。

例

例 1: ファイルをインポートする

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

このコマンドは、"C:\Temp\MyAccount.publishsettings" ファイルをインポートします。

パラメーター

-Environment

Azure 環境を指定します。

Azure 環境は、グローバル Azure 用の AzureCloud や、中国の 21Vianet によって運用される AzureChinaCloud for Azure など、Microsoft Azure の独立したデプロイです。 また、Azure Pack と WAPack コマンドレットを使用して、オンプレミスの Azure 環境を作成することもできます。 詳細については、「Azure Pack」を参照してください。

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

-Profile

このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。

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

このコマンドレットへの入力はプロパティ名でパイプできますが、値によるパイプ処理は行いません。

出力

None

このコマンドレットは出力を生成しません。

メモ

  • "発行設定ファイル" は、.publishsettings ファイル名拡張子を持つ XML ファイルです。 このファイルには、Azure サブスクリプションの管理資格情報を提供するエンコードされた証明書が含まれています。 このファイルをインポートした後、セキュリティ 上のリスクを回避するために削除します。
  • "サブスクリプション データ ファイル" は、コンピューターに安全に保存できる XML ファイルです。 既定では、移動ユーザー プロファイル ($home/AppData/Roaming) に保存されます。