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

New-AzDevCenterUserDevBoxCustomizationGroup

模块:

Az.DevCenter

将自定义项应用于 Dev Box。

语法

New-AzDevCenterUserDevBoxCustomizationGroup
   -Endpoint <String>
   -CustomizationGroupName <String>
   -DevBoxName <String>
   -ProjectName <String>
   [-UserId <String>]
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserDevBoxCustomizationGroup
   -Endpoint <String>
   -InputObject <IDevCenterdataIdentity>
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserDevBoxCustomizationGroup
   -DevCenterName <String>
   -InputObject <IDevCenterdataIdentity>
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserDevBoxCustomizationGroup
   -DevCenterName <String>
   -CustomizationGroupName <String>
   -DevBoxName <String>
   -ProjectName <String>
   [-UserId <String>]
   [-Task <ICustomizationTask[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

将自定义项应用于 Dev Box。

示例

示例 1：创建自定义 groupby 终结点

$task = @{
    Name = "catalogName/choco"
    DisplayName = "choco"
    Parameter = @{
        PackageName = "vscode"
        PackageVersion = "1.0.0"
    }
    RunAs = "System"
    TimeoutInSecond = 120
}
$tasks = @($task)
New-AzDevCenterUserDevBoxCustomizationGroup -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -ProjectName DevProject -UserId 786a823c-8037-48ab-89b8-8599901e67d0 -DevBoxName myDevBox -CustomizationGroupName Provisioning -Task $tasks

此命令为开发框“myDevBox”创建自定义组“Provisoning”。

示例 2：创建自定义组

New-AzDevCenterUserDevBoxCustomizationGroup -DevCenterName Contoso -ProjectName DevProject -UserId "me" -DevBoxName myDevBox -CustomizationGroupName Provisioning -Task $tasks

此命令为开发框“myDevBox”创建自定义组“Provisoning”。

示例 3：创建自定义 groupby 终结点和 InputObject

$customizationGroupInput = @{"CustomizationGroupName" = "Provisioning"; "DevBoxName" = "myDevBox"; "UserId" = "me"; "ProjectName" = "DevProject" }
New-AzDevCenterUserDevBoxCustomizationGroup -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -InputObject $customizationGroupInput -Task $tasks

此命令为开发框“myDevBox”创建自定义组“Provisoning”。

示例 4：创建自定义组比开发人员中心和 InputObject

$customizationGroupInput = @{"CustomizationGroupName" = "Provisioning"; "DevBoxName" = "myDevBox"; "UserId" = "786a823c-8037-48ab-89b8-8599901e67d0"; "ProjectName" = "DevProject" }
New-AzDevCenterUserDevBoxCustomizationGroup -DevCenterName Contoso -InputObject $customizationGroupInput -Task $tasks

此命令为开发框“myDevBox”创建自定义组“Provisoning”。

参数

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomizationGroupName

自定义组名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DefaultProfile

DefaultProfile 参数不起作用。 如果对其他订阅执行 cmdlet，请使用 SubscriptionId 参数。

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DevBoxName

Dev Box 的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DevCenterName

要对其执行作的 DevCenter。

类型:	String
别名:	DevCenter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Endpoint

要运行的特定于 DevCenter 的 URI。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

类型:	IDevCenterdataIdentity
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ProjectName

要对其执行作的 DevCenter 项目。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Task

要应用的任务。 默认情况下，在列出自定义组时，将从响应中排除任务。 若要包含它们，请使用 include=tasks queryparameter。 若要构造，请参阅 TASK 属性的 NOTES 部分并创建哈希表。

类型:	ICustomizationTask[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UserId

用户的 AAD 对象 ID。 如果值为“me”，则标识取自身份验证上下文。

类型:	String
Position:	Named
默认值:	"me"
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

IDevCenterdataIdentity

输出

ICustomizationGroup