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

New-AzDevCenterUserDevBoxSnapshot

模块:: Az.DevCenter Module

捕获 Dev Box 的手动快照。\n完成后，将生成 snapshotId。\n若要检索所有快照及其相应的 ID，请使用列表快照终结点。

语法

Capture (默认值)

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

CaptureViaIdentity

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

CaptureByDevCenter

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

CaptureViaIdentityByDevCenter

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

说明

捕获 Dev Box 的手动快照。\n完成后，将生成 snapshotId。\n若要检索所有快照及其相应的 ID，请使用列表快照终结点。

示例

示例 1：按终结点创建 Dev Box 快照

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

此命令为使用终结点分配给指定用户的开发框“myDevBox”创建快照。

示例 2：按开发人员中心创建 Dev Box 快照

New-AzDevCenterUserDevBoxSnapshot `
  -DevCenterName "ContosoDevCenter" `
  -ProjectName "DevProject" `
  -UserId "me" `
  -DevBoxName "myDevBox"

此命令为使用开发人员中心名称分配给当前已登录用户的开发框“myDevBox”创建快照。

示例 3：按终结点和 InputObject 创建 Dev Box 快照

$snapshotInput = @{
    DevBoxName = "myDevBox"
    UserId = "me"
    ProjectName = "DevProject"
}
New-AzDevCenterUserDevBoxSnapshot `
  -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" `
  -InputObject $snapshotInput

此命令使用终结点和标识对象为开发框“myDevBox”创建快照。

示例 4：通过开发人员中心和 InputObject 创建 Dev Box 快照

$snapshotInput = @{
    DevBoxName = "myDevBox"
    UserId = "786a823c-8037-48ab-89b8-8599901e67d0"
    ProjectName = "DevProject"
}
New-AzDevCenterUserDevBoxSnapshot `
  -DevCenterName "ContosoDevCenter" `
  -InputObject $snapshotInput

此命令使用开发人员中心名称和标识对象为开发框“myDevBox”创建快照。

参数

-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

参数集

Capture

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

CaptureByDevCenter

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

-DevCenterName

要对其执行作的 DevCenter。

参数属性

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

参数集

CaptureByDevCenter

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

CaptureViaIdentityByDevCenter

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

-Endpoint

要作的特定于 DevCenter 的 URI。

参数属性

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

参数集

Capture

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

CaptureViaIdentity

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

-InputObject

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

参数属性

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

参数集

CaptureViaIdentity

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

CaptureViaIdentityByDevCenter

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

-NoWait

异步运行命令

参数属性

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

参数集

(All)

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

-ProjectName

项目的名称。

参数属性

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

参数集

Capture

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

CaptureByDevCenter

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

-UserId

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

参数属性

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

参数集

Capture

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

CaptureByDevCenter

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-AzDevCenterUserDevBoxSnapshot

语法

Capture (默认值)

CaptureViaIdentity

CaptureByDevCenter

CaptureViaIdentityByDevCenter

说明

示例

示例 1：按终结点创建 Dev Box 快照

示例 2：按开发人员中心创建 Dev Box 快照

示例 3：按终结点和 InputObject 创建 Dev Box 快照

示例 4：通过开发人员中心和 InputObject 创建 Dev Box 快照

参数

-AsJob

参数属性

参数集

-Confirm

参数属性

参数集

-DefaultProfile

参数属性

参数集

-DevBoxName

参数属性

参数集

-DevCenterName

参数属性

参数集

-Endpoint

参数属性

参数集

-InputObject

参数属性

参数集

-NoWait

参数属性

参数集

-ProjectName

参数属性

参数集

-UserId

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters

输入

IDevCenterdataIdentity

输出

IOperationStatus

反馈