New-AzureDeployment

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

サービスからデプロイを作成します。

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
  • Stop
  • [中断]
型: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