Import-AzurePublishSettingsFile
Windows PowerShell で Azure アカウントを管理できる発行設定ファイルをインポートします。
注
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
構文
Default (既定)
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」を参照してください。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
パラメーターのプロパティ
| 型: | AzureSMProfile |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PublishSettingsFile
Import-AzurePublishSettingsFile コマンドレットは、Azure アカウントに関する情報を含む発行設定ファイル (*.publishsettings) をインポートし、サブスクリプション データ ファイルをコンピューターに保存します。 コマンドレットが完了したら、Windows PowerShell で Azure アカウントを管理できます。
Import-AzurePublishSettingsFile を実行する前に、Get-AzurePublishSettingsFile を実行します。このファイルは、発行設定ファイルをダウンロードして保存してインポートできます。
Windows PowerShell で Azure アカウントを使用できるようにするには、発行設定ファイルまたは Add-AzureAccount コマンドレットを使用します。 設定ファイルを発行すると、スクリプトとバックグラウンド ジョブを無人で実行できるように、セッションを事前に準備できます。 ただし、すべてのサービスが設定ファイルの発行をサポートしているわけではありません。 たとえば、 AzureResourceManager モジュールでは、設定ファイルの発行はサポートされていません。
セキュリティ上の注意: 発行設定ファイルには、エンコードされているが暗号化されていない管理証明書が含まれています。 悪意のあるユーザーが発行設定ファイルにアクセスすると、Azure サービスを編集、作成、削除できる可能性があります。 セキュリティのベスト プラクティスとして、ファイルをダウンロードフォルダーまたはドキュメント フォルダー内の場所に保存し、Import-AzurePublishSettingsFile コマンドレットを使用して設定をインポートした後で削除します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
入力
None
このコマンドレットへの入力はプロパティ名でパイプできますが、値によるパイプ処理は行いません。
出力
None
このコマンドレットは出力を生成しません。
メモ
- "発行設定ファイル" は、.publishsettings ファイル名拡張子を持つ XML ファイルです。 このファイルには、Azure サブスクリプションの管理資格情報を提供するエンコードされた証明書が含まれています。 このファイルをインポートした後、セキュリティ 上のリスクを回避するために削除します。
- "サブスクリプション データ ファイル" は、コンピューターに安全に保存できる XML ファイルです。 既定では、移動ユーザー プロファイル ($home/AppData/Roaming) に保存されます。