New-AzureDeployment
サービスからデプロイを作成します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az 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
サービス構成ファイルの完全パスを指定します。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DoNotStart
このコマンドレットがデプロイを開始しないことを指定します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtensionConfiguration
拡張構成オブジェクトの配列を指定します。
Type: | ExtensionConfigurationInput[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InformationAction
このコマンドレットが情報イベントに応答する方法を指定します。
このパラメーターの有効値は、次のとおりです。
- 続行
- Ignore
- Inquire
- SilentlyContinue
- Stop
- Suspend
Type: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InformationVariable
情報変数を指定します。
Type: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Label
デプロイのラベル名を指定します。 ラベルを指定しない場合、このコマンドレットは GUID を使用します。
Type: | String |
Position: | 4 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
デプロイ名を指定します。 名前を指定しない場合、このコマンドレットは GUID を使用します。
Type: | String |
Aliases: | DeploymentName |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
同じサブスクリプションまたはプロジェクト内のストレージ内の .cspkg ファイルのパスまたは URI を指定します。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
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 |
-ServiceName
デプロイの Azure サービスの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Slot
このコマンドレットによってデプロイが作成される環境を指定します。 有効な値は、ステージングと運用です。 既定値は Production です。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TreatWarningsAsError
警告メッセージがエラーであることを指定します。 このパラメーターを指定すると、警告メッセージが表示され、デプロイが失敗します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |