New-AzureDeployment
サービスからデプロイを作成します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される PowerShell モジュールです。
重要
現在、Cloud Services (クラシック) は新しいお客様に対して非推奨となっており、2024 年 8 月 31 日に、すべてのお客様に対して廃止される予定です。 新しいデプロイでは、新しい Azure Resource Manager ベースのデプロイ モデル、 Azure Cloud Services (延長サポート) を使用してください。
構文
New-AzureDeployment
[-ServiceName] <String>
[-Package] <String>
[-Configuration] <String>
[-Slot] <String>
[[-Label] <String>]
[[-Name] <String>]
[-DoNotStart]
[-TreatWarningsAsError]
[-ExtensionConfiguration <ExtensionConfigurationInput[]>]
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
説明
New-AzureDeployment コマンドレットは、Web ロールと worker ロールで構成されるサービスから Azure デプロイを作成します。 このコマンドレットは、パッケージ ファイル (.cspkg) とサービス構成ファイル (.cscfg) に基づいてデプロイを作成します。 デプロイ環境内で一意の名前を指定します。
New-AzureVM コマンドレットを使用して、Azure 仮想マシンに基づいてデプロイを作成します。
例
例 1: デプロイを作成する
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -Label "ContosoDeployment"
このコマンドは、ContosoPackage.cspkg という名前のパッケージと ContosoConfiguration.cscfg という名前の構成に基づいて運用デプロイを作成します。 このコマンドは、デプロイのラベルを指定します。 名前は指定しません。 このコマンドレットは、名前として GUID を作成します。
例 2: 拡張機能の構成に基づいてデプロイを作成する
PS C:\> New-AzureDeployment -ServiceName "ContosoService" -Slot "Production" -Package "https://contosostorage.blob.core.windows.net/container06/ContosoPackage.cspkg" -Configuration "C:\packages\ContosoConfiguration.cscfg" -ExtensionConfiguration "C:\packages\ContosoExtensionConfig.cscfg"
このコマンドは、パッケージと構成に基づいて運用デプロイを作成します。 このコマンドは、ContosoExtensionConfig.cscfg という名前の拡張機能構成を指定します。 このコマンドレットは、名前とラベルとして GUID を作成します。
パラメーター
-Configuration
サービス構成ファイルの完全パスを指定します。
型: | String |
配置: | 2 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DoNotStart
このコマンドレットがデプロイを開始しないことを指定します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ExtensionConfiguration
拡張構成オブジェクトの配列を指定します。
型: | ExtensionConfigurationInput[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- 阻止
- [中断]
型: | ActionPreference |
Aliases: | infa |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-InformationVariable
情報変数を指定します。
型: | String |
Aliases: | iv |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Label
デプロイのラベル名を指定します。 ラベルを指定しない場合、このコマンドレットは GUID を使用します。
型: | String |
配置: | 4 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
デプロイ名を指定します。 名前を指定しない場合、このコマンドレットは GUID を使用します。
型: | String |
Aliases: | DeploymentName |
配置: | 5 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Package
同じサブスクリプションまたはプロジェクト内のストレージ内の .cspkg ファイルのパスまたは URI を指定します。
型: | String |
配置: | 1 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
型: | AzureSMProfile |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServiceName
デプロイの Azure サービスの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Slot
このコマンドレットによってデプロイが作成される環境を指定します。 有効な値は、ステージングと運用です。 既定値は Production です。
型: | String |
配置: | 3 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-TreatWarningsAsError
警告メッセージがエラーであることを指定します。 このパラメーターを指定すると、警告メッセージが表示され、デプロイが失敗します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |