你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzureRmDeploymentManagerServiceUnit

模块:

AzureRM.DeploymentManager

在服务拓扑中的服务下创建新的服务单元。

语法

New-AzureRmDeploymentManagerServiceUnit
   [-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-AzureRmDeploymentManagerServiceUnit
   [-ResourceGroupName] <String>
   [-ServiceName] <String>
   [-Name] <String>
   -Location <String>
   -TargetResourceGroup <String>
   -DeploymentMode <String>
   [-ParametersUri <String>]
   [-TemplateUri <String>]
   [-TemplateArtifactSourceRelativePath <String>]
   [-ParametersArtifactSourceRelativePath <String>]
   [-Tag <Hashtable>]
   [-ServiceTopology] <PSServiceTopologyResource>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeploymentManagerServiceUnit
   [-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-AzureRmDeploymentManagerServiceUnit
   [-ResourceGroupName] <String>
   [-Name] <String>
   -Location <String>
   -TargetResourceGroup <String>
   -DeploymentMode <String>
   [-ParametersUri <String>]
   [-TemplateUri <String>]
   [-TemplateArtifactSourceRelativePath <String>]
   [-ParametersArtifactSourceRelativePath <String>]
   [-Tag <Hashtable>]
   [-Service] <PSServiceResource>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmDeploymentManagerServiceUnit
   [-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-AzureRmDeploymentManagerServiceUnit cmdlet 在服务拓扑中的服务下创建服务，并返回表示该服务单元的对象。 按服务单元的名称、服务名称、服务拓扑和资源组名称指定服务单元。

该 cmdlet 返回 ServiceUnit 对象。 可以在本地修改此对象，然后使用 Set-AzureRmDeploymentManagerService cmdlet 对服务应用更改。

示例

示例 1

PS C:\> New-AzureRmDeploymentManagerServiceUnit -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"

此 cmdlet 在 ContosoResourceGroup 的拓扑 ContosoServiceTopology 中的拓扑 ContosoServiceTopology（位于美国中部）下创建名为 ContosoService2Storage 的新服务单元。 模板和参数文件定义为服务拓扑 ContosoServiceTopology 中引用的项目源位置的相对路径。 此模板中定义的资源将部署到目标资源组 service2ResourceGroup 中，并将部署模式设置为增量。

示例 2

PS C:\> New-AzureRmDeploymentManagerServiceUnit -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"

此 cmdlet 在 ContosoResourceGroup 的拓扑 ContosoServiceTopology 中的拓扑 ContosoServiceTopology（位于美国中部）下创建名为 ContosoService2Storage 的新服务单元。 模板和参数引用作为 SAS URI 作为项目源 ResourceId 提供，未在服务拓扑 ContosoServiceTopology1 中提供。 此模板中定义的资源将部署到目标资源组 service2ResourceGroup 中，部署模式设置为“完成”。

参数

-AsJob

在后台运行 cmdlet

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:	IAzureContextContainer
Aliases:	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

在服务单元中部署资源时要使用的部署模式。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ParametersUri

在服务单元中部署资源时要使用的部署模式。

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

-Service

应在其中创建服务单元的服务对象。

Type:	PSServiceResource
Position:	2
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

-ServiceResourceId

应在其中创建服务单元的服务资源标识符。

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceTopology

应在其中创建服务单元的服务拓扑对象。

Type:	PSServiceTopologyResource
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServiceTopologyName

此服务单元所属的 serivce 拓扑的名称。

Type:	String
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

在服务单元中部署资源时要使用的部署模式。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateUri

在服务单元中部署资源时要使用的部署模式。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 cmdlet 未运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

PSServiceUnitResource

相关链接

• Get-AzureRmDeploymentManagerServiceUnit
• Remove-AzureRmDeploymentManagerServiceUnit
• Set-AzureRmDeploymentManagerServiceUnit