New-AzDeploymentManagerServiceUnit
指定したサービスとサービス トポロジの下にサービス ユニットを作成します。
構文
New-AzDeploymentManagerServiceUnit
[-ResourceGroupName] <String>
[-ServiceTopologyName] <String>
[-ServiceName] <String>
[-Name] <String>
-Location <String>
-TargetResourceGroup <String>
-DeploymentMode <String>
[-ParametersUri <String>]
[-TemplateUri <String>]
[-TemplateArtifactSourceRelativePath <String>]
[-ParametersArtifactSourceRelativePath <String>]
[-Tag <Hashtable>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzDeploymentManagerServiceUnit
[-ResourceGroupName] <String>
[-ServiceName] <String>
[-Name] <String>
-Location <String>
-TargetResourceGroup <String>
-DeploymentMode <String>
[-ParametersUri <String>]
[-TemplateUri <String>]
[-TemplateArtifactSourceRelativePath <String>]
[-ParametersArtifactSourceRelativePath <String>]
[-Tag <Hashtable>]
[-ServiceTopologyObject] <PSServiceTopologyResource>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzDeploymentManagerServiceUnit
[-ResourceGroupName] <String>
[-ServiceName] <String>
[-Name] <String>
-Location <String>
-TargetResourceGroup <String>
-DeploymentMode <String>
[-ParametersUri <String>]
[-TemplateUri <String>]
[-TemplateArtifactSourceRelativePath <String>]
[-ParametersArtifactSourceRelativePath <String>]
[-Tag <Hashtable>]
[-ServiceTopologyResourceId] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzDeploymentManagerServiceUnit
[-ResourceGroupName] <String>
[-Name] <String>
-Location <String>
-TargetResourceGroup <String>
-DeploymentMode <String>
[-ParametersUri <String>]
[-TemplateUri <String>]
[-TemplateArtifactSourceRelativePath <String>]
[-ParametersArtifactSourceRelativePath <String>]
[-Tag <Hashtable>]
[-ServiceObject] <PSServiceResource>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzDeploymentManagerServiceUnit
[-ResourceGroupName] <String>
[-Name] <String>
-Location <String>
-TargetResourceGroup <String>
-DeploymentMode <String>
[-ParametersUri <String>]
[-TemplateUri <String>]
[-TemplateArtifactSourceRelativePath <String>]
[-ParametersArtifactSourceRelativePath <String>]
[-Tag <Hashtable>]
[-ServiceResourceId] <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-AzDeploymentManagerServiceUnit コマンドレットは、サービス トポロジ内のサービスの下にサービスを作成し、そのサービス ユニットを表すオブジェクトを返します。 サービス ユニットの名前、サービス名、サービス トポロジ、リソース グループ名を指定します。
コマンドレットは ServiceUnit オブジェクトを返します。 このオブジェクトをローカルで変更し、Set-AzDeploymentManagerService コマンドレットを使用してサービスに変更を適用できます。
例
例 1
New-AzDeploymentManagerServiceUnit -ResourceGroupName ContosoResourceGroup -ServiceTopologyName ContosoServiceTopology -ServiceName ContosoService2 -Name ContosoService2Storage -Location "Central US" -TargetResourceGroup service2ResourceGroup -DeploymentMode Incremental -TemplateArtifactSourceRelativePath "Templates/Service2.Storage.json" -ParametersArtifactSourceRelativePath "Parameters/Service2Storage.Parameters.json"
このコマンドレットは、ContosoServiceTopology トポロジの ContosoServiceTopology のサービス ContosoService2 の下にある ContosoResourceGroup 内の ContosoService2Storage という名前の新しいサービス ユニットを作成します。 テンプレート ファイルとパラメーター ファイルは、サービス トポロジ ContosoServiceTopology で参照される成果物ソースの場所への相対パスとして定義されます。 このテンプレートで定義されているリソースは、デプロイ モードが増分に設定されたターゲット リソース グループ service2ResourceGroup にデプロイされます。
例 2
New-AzDeploymentManagerServiceUnit -ResourceGroupName ContosoResourceGroup -ServiceTopologyName ContosoServiceTopology1 -ServiceName ContosoService2 -Name ContosoService2Storage -Location "Central US" -TargetResourceGroup service2ResourceGroup -DeploymentMode Complete -TemplateUri "https://ContosoStorage.blob.core.windows.net/ContosoArtifacts/Templates/Service2.Storage.json?sasParameters" -ParametersUri "https://ContosoStorage.blob.core.windows.net/ContosoArtifacts/Parameters/Service2Storage.Parameters.json?sasParameters"
このコマンドレットは、ContosoServiceTopology トポロジの ContosoServiceTopology のサービス ContosoService2 の下にある ContosoResourceGroup 内の ContosoService2Storage という名前の新しいサービス ユニットを作成します。 テンプレートとパラメーターの参照は、サービス トポロジ ContosoServiceTopology1 で提供されなかった成果物ソース ResourceId として SAS URI として提供されます。 このテンプレートで定義されているリソースは、デプロイ モードが [完了] に設定されたターゲット リソース グループ service2ResourceGroup にデプロイされます。
パラメーター
-AsJob
バックグラウンドでコマンドレットを実行する
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentMode
サービス ユニット内のリソースをデプロイするときに使用するデプロイ モード。
Type: | String |
Accepted values: | Incremental, Complete |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
サービス ユニット リソースの場所。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
サービス ユニットの名前。
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParametersArtifactSourceRelativePath
アーティファクト ソースを基準としたパラメーター ファイルへのパス。 ServiceTopology で ArtifactSource を参照する必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ParametersUri
パラメーター ファイルへの SAS URI。 ArtifactSourceId が ServiceTopology で参照されている場合は、ParametersArtifactSourceRelativePath を使用して相対パスを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
リソース グループです。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceName
このサービス ユニットが含まれるサービスの名前。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceObject
サービス ユニットを作成する必要があるサービス オブジェクト。
Type: | PSServiceResource |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceResourceId
サービス ユニットを作成する必要があるサービス リソース識別子。
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceTopologyName
このサービス ユニットが含まれるサービス トポロジの名前。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceTopologyObject
サービス ユニットを作成する必要があるサービス トポロジ オブジェクト。
Type: | PSServiceTopologyResource |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServiceTopologyResourceId
サービス ユニットを作成する必要があるサービス トポロジ リソース識別子。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
リソース タグを表すハッシュ テーブル。
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TargetResourceGroup
サービス ユニットの下のリソースがデプロイされる場所を決定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateArtifactSourceRelativePath
成果物ソースを基準としたテンプレート ファイルへのパス。 ServiceTopology で ArtifactSource を参照する必要があります。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplateUri
テンプレート ファイルへの SAS URI。 ServiceTopology で ArtifactSourceId が参照されている場合は、TemplateArtifactSourceRelativePath を使用して相対パスを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |