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

New-AzDevCenterUserDevBoxAddOn

创建开发箱插件。

语法

CreateExpanded (默认值)

New-AzDevCenterUserDevBoxAddOn
    -Endpoint <String>
    -AddOnName <String>
    -DevBoxName <String>
    -ProjectName <String>
    [-UserId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpanded

New-AzDevCenterUserDevBoxAddOn
    -Endpoint <String>
    -InputObject <IDevCenterdataIdentity>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaIdentityExpandedByDevCenter

New-AzDevCenterUserDevBoxAddOn
    -DevCenterName <String>
    -InputObject <IDevCenterdataIdentity>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateExpandedByDevCenter

New-AzDevCenterUserDevBoxAddOn
    -DevCenterName <String>
    -AddOnName <String>
    -DevBoxName <String>
    -ProjectName <String>
    [-UserId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

创建开发箱插件。

示例

示例 1:按终结点和用户 ID 创建 Dev Box 加载项

New-AzDevCenterUserDevBoxAddOn `
  -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" `
  -ProjectName "DevProject" `
  -DevBoxName "myDevBox" `
  -AddOnName "devboxtunnel-sys-default" `
  -UserId "786a823c-8037-48ab-89b8-8599901e67d0"

此命令使用终结点为分配给用户“786a823c-8037-48ab-89b8-85999901e67d0”的开发框“myDevBox”创建加载项“devboxtunnel-sys-default”。

示例 2:按开发人员中心名称和当前用户创建 Dev Box 加载项

New-AzDevCenterUserDevBoxAddOn `
  -DevCenterName "ContosoDevCenter" `
  -ProjectName "DevProject" `
  -DevBoxName "myDevBox" `
  -AddOnName "devboxtunnel-sys-default" `
  -UserId "me"

此命令为使用开发人员中心名称分配给当前登录用户的开发框“myDevBox”创建加载项“devboxtunnel-sys-default”。

示例 3:使用 InputObject 和终结点创建 Dev Box 加载项

$addOnInput = @{
    DevBoxName = "myDevBox"
    UserId = "786a823c-8037-48ab-89b8-8599901e67d0"
    ProjectName = "DevProject"
    AddOnName = "devboxtunnel-sys-default"
}
New-AzDevCenterUserDevBoxAddOn `
  -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" `
  -InputObject $addOnInput

此命令使用终结点和标识对象为开发框“myDevBox”创建加载项“devboxtunnel-sys-default”。

示例 4:使用 InputObject 和开发人员中心名称创建 Dev Box 加载项

$addOnInput = @{
    DevBoxName = "myDevBox"
    UserId = "me"
    ProjectName = "DevProject"
    AddOnName = "devboxtunnel-sys-default"
}
New-AzDevCenterUserDevBoxAddOn `
  -DevCenterName "ContosoDevCenter" `
  -InputObject $addOnInput

此命令使用开发人员中心名称和标识对象为开发框“myDevBox”创建加载项“devboxtunnel-sys-default”。

参数

-AddOnName

Dev Box 插件的名称。

参数属性

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

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateExpandedByDevCenter
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AsJob

以作业身份运行命令

参数属性

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

参数集

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

-Confirm

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

参数属性

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

参数集

(All)
Position:Named
必需:False
来自管道的值: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

-NoWait

异步运行命令

参数属性

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

参数集

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

-ProjectName

要执行作的 DevCenter 项目。

参数属性

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

参数集

CreateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
CreateExpandedByDevCenter
Position:Named
必需:True
来自管道的值: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

输入

IDevCenterdataIdentity

输出

IDevBoxAddOn