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

New-AzDevCenterUserEnvironment

模块:

Az.DevCenter

创建或更新环境。

语法

New-AzDevCenterUserEnvironment
   -Endpoint <String>
   -Name <String>
   -ProjectName <String>
   [-UserId <String>]
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserEnvironment
   -Endpoint <String>
   -InputObject <IDevCenterdataIdentity>
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserEnvironment
   -DevCenterName <String>
   -InputObject <IDevCenterdataIdentity>
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzDevCenterUserEnvironment
   -DevCenterName <String>
   -Name <String>
   -ProjectName <String>
   [-UserId <String>]
   -CatalogName <String>
   -EnvironmentDefinitionName <String>
   -EnvironmentType <String>
   [-ExpirationDate <DateTime>]
   [-Parameter <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建或更新环境。

示例

示例 1：按终结点创建环境

$functionAppParameters = @{"name" = "testfuncApp" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -Name "envtest" -ProjectName DevProject -CatalogName CentralCatalog -EnvironmentDefinitionName FunctionApp -EnvironmentType DevTest -Parameter $functionAppParameters -ExpirationDate $dateIn8Months

此命令将创建名为 envtest 的环境“到项目”DevProject”。

示例 2：按开发人员中心创建环境

$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -DevCenterName Contoso -Name "envtest" -ProjectName DevProject -CatalogName CentralCatalog -EnvironmentDefinitionName Sandbox -EnvironmentType DevTest -ExpirationDate $dateIn8Months

此命令将创建名为 envtest 的环境“到项目”DevProject”。

示例 3：按终结点和 InputObject 创建环境

$envInput = @{"UserId" = "me"; "ProjectName" = "DevProject"; "EnvironmentName" = "envtest" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -Endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" -InputObject $envInput -CatalogName CentralCatalog -EnvironmentDefinitionName Sandbox -EnvironmentType DevTest -ExpirationDate $dateIn8Months

此命令将创建名为 envtest 的环境“到项目”DevProject”。

示例 4：通过开发人员中心和 InputObject 创建环境

$functionAppParameters = @{"name" = "testfuncApp" }
$envInput = @{"UserId" = "me"; "ProjectName" = "DevProject"; "EnvironmentName" = "envtest" }
$currentDate = Get-Date
$dateIn8Months = $currentDate.AddMonths(8)

New-AzDevCenterUserEnvironment -DevCenterName Contoso -InputObject $envInput -CatalogName CentralCatalog -EnvironmentDefinitionName FunctionApp -EnvironmentType DevTest -Parameter $functionAppParameters -ExpirationDate $dateIn8Months

此命令将创建名为 envtest 的环境“到项目”DevProject”。

参数

-AsJob

以作业身份运行命令

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

-CatalogName

目录的名称。

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

-Confirm

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

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

-DefaultProfile

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

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

-DevCenterName

要对其执行作的 DevCenter。

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

-Endpoint

要运行的特定于 DevCenter 的 URI。

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

-EnvironmentDefinitionName

环境定义的名称。

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

-EnvironmentType

环境类型。

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

-ExpirationDate

到期日期的触发时间（UTC），之后将删除环境和关联的资源。

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

-InputObject

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

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

-Name

环境的名称。

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

-NoWait

异步运行命令

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

-Parameter

环境的 Parameters 对象。

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

-ProjectName

要对其执行作的 DevCenter 项目。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	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

输出

IEnvironment