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

New-AzDevCenterUserDevBoxCustomizationGroup

模块:: Az.DevCenter Module

将自定义项应用于开发箱。

语法

CreateExpanded (默认值)

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

CreateViaIdentityExpanded

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

CreateViaIdentityExpandedByDevCenter

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

CreateExpandedByDevCenter

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

说明

将自定义项应用于开发箱。

示例

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

$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”创建自定义组“预配”。

示例 2：按开发人员中心创建自定义组

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

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

示例 3：按终结点和 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”创建自定义组“预配”。

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

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

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

参数

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CustomizationGroupName

自定义组名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	PSObject
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzureRMContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DevBoxName

开发箱的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DevCenterName

要对其执行作的 DevCenter。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False
别名:	DevCenter

参数集

CreateViaIdentityExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Endpoint

要作的特定于 DevCenter 的 URI。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-InputObject

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

参数属性

类型:	IDevCenterdataIdentity
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateViaIdentityExpanded

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateViaIdentityExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ProjectName

要执行作的 DevCenter 项目。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateExpandedByDevCenter

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Task

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

参数属性

类型:	ICustomizationTask[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UserId

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

参数属性

类型:	String
默认值:	me
支持通配符:	False
不显示:	False

参数集

CreateExpanded

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CreateExpandedByDevCenter

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzDevCenterUserDevBoxCustomizationGroup

语法

CreateExpanded (默认值)

CreateViaIdentityExpanded

CreateViaIdentityExpandedByDevCenter

CreateExpandedByDevCenter

说明

示例

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

示例 2：按开发人员中心创建自定义组

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

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

参数

-Confirm

参数属性

参数集

-CustomizationGroupName

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DevBoxName

参数属性

参数集

-DevCenterName

参数属性

参数集

-Endpoint

参数属性

参数集

-InputObject

参数属性

参数集

-ProjectName

参数属性

参数集

-Task

参数属性

参数集

-UserId

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

IDevCenterdataIdentity

输出

ICustomizationGroup

反馈