Import-AzurePublishSettingsFile
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) に保存されます。