通过

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

New-AzLabServicesLab

  • 参考
模块:
Az.LabServices

用于创建实验室资源的操作。

语法

New-AzLabServicesLab
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-AdditionalCapabilityInstallGpuDriver <EnableState>]
   [-AdminUserPassword <SecureString>]
   [-AdminUserUsername <String>]
   [-AutoShutdownProfileDisconnectDelay <TimeSpan>]
   [-AutoShutdownProfileIdleDelay <TimeSpan>]
   [-AutoShutdownProfileNoConnectDelay <TimeSpan>]
   [-AutoShutdownProfileShutdownOnDisconnect <EnableState>]
   [-AutoShutdownProfileShutdownOnIdle <ShutdownOnIdleMode>]
   [-AutoShutdownProfileShutdownWhenNotConnected <EnableState>]
   [-ConnectionProfileClientRdpAccess <ConnectionType>]
   [-ConnectionProfileClientSshAccess <ConnectionType>]
   [-ConnectionProfileWebRdpAccess <ConnectionType>]
   [-ConnectionProfileWebSshAccess <ConnectionType>]
   [-Description <String>]
   [-ImageReferenceId <String>]
   [-ImageReferenceOffer <String>]
   [-ImageReferencePublisher <String>]
   [-ImageReferenceSku <String>]
   [-ImageReferenceVersion <String>]
   [-LabPlanId <String>]
   [-NetworkProfileLoadBalancerId <String>]
   [-NetworkProfilePublicIPId <String>]
   [-NetworkProfileSubnetId <String>]
   [-NonAdminUserPassword <SecureString>]
   [-NonAdminUserUsername <String>]
   [-RosterProfileActiveDirectoryGroupId <String>]
   [-RosterProfileLmsInstance <String>]
   [-RosterProfileLtiClientId <String>]
   [-RosterProfileLtiContextId <String>]
   [-RosterProfileLtiRosterEndpoint <String>]
   [-SecurityProfileOpenAccess <EnableState>]
   [-SkuCapacity <Int32>]
   [-SkuFamily <String>]
   [-SkuName <String>]
   [-SkuSize <String>]
   [-SkuTier <SkuTier>]
   [-Tag <Hashtable>]
   [-Title <String>]
   [-VirtualMachineProfileCreateOption <CreateOption>]
   [-VirtualMachineProfileUsageQuota <TimeSpan>]
   [-VirtualMachineProfileUseSharedPassword <EnableState>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

用于创建实验室资源的操作。

示例

示例 1：创建新实验室。

New-AzLabServicesLab `
        -Name "NewLab" `
        -ResourceGroupName $ENV:ResourceGroupName `
        -Location $ENV:Location `
        -AdditionalCapabilityInstallGpuDriver Disabled `
        -AdminUserPassword "PlaceholderPassword" `
        -AdminUserUsername "PlaceholderAccountName" `
        -AutoShutdownProfileShutdownOnDisconnect Disabled `
        -AutoShutdownProfileShutdownOnIdle None `
        -AutoShutdownProfileShutdownWhenNotConnected Disabled `
        -ConnectionProfileClientRdpAccess Public `
        -ConnectionProfileClientSshAccess None `
        -ConnectionProfileWebRdpAccess None `
        -ConnectionProfileWebSshAccess None `
        -Description "New lab description" `
        -ImageReferenceOffer "Windows-10" `
        -ImageReferencePublisher "MicrosoftWindowsDesktop" `
        -ImageReferenceSku "20h2-pro" `
        -ImageReferenceVersion "latest" `
        -SecurityProfileOpenAccess Disabled `
        -SkuCapacity 3 `
        -SkuName "Standard" `
        -Title $ENV:NewLabName `
        -VirtualMachineProfileCreateOption "TemplateVM" `
        -VirtualMachineProfileUseSharedPassword Enabled

Location Name
-------- ----
westus2  NewLab

创建新的实验室。

参数

-AdditionalCapabilityInstallGpuDriver

用于预安装专用 GPU 驱动程序的标志。

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

-AdminUserPassword

用户的密码。 TemplateVM createOption 需要此项。

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

-AdminUserUsername

登录到实验室 VM 时要使用的用户名。

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

-AsJob

以作业身份运行命令

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

-AutoShutdownProfileDisconnectDelay

如果启用此行为，VM 将在用户断开连接后保持运行的时间量。

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

-AutoShutdownProfileIdleDelay

如果启用此行为，VM 将在关闭之前空闲的时间量。

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

-AutoShutdownProfileNoConnectDelay

如果未建立连接并启用此行为，VM 在关闭之前保持运行的时间量。

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

-AutoShutdownProfileShutdownOnDisconnect

是否在断开连接时关闭

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

-AutoShutdownProfileShutdownOnIdle

VM 在空闲一段时间后是否关闭。

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

-AutoShutdownProfileShutdownWhenNotConnected

VM 是否在一段时间后未连接到 VM 时关闭。

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

-Confirm

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

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

-ConnectionProfileClientRdpAccess

通过 RDP 启用客户端访问的访问级别。

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

-ConnectionProfileClientSshAccess

通过 SSH 启用客户端访问的访问级别。

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

-ConnectionProfileWebRdpAccess

通过 RDP 为 Web 访问启用的访问级别。

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

-ConnectionProfileWebSshAccess

通过 SSH 为 Web 访问启用的访问级别。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-Description

实验室的说明。

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

-ImageReferenceId

映像资源 ID

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

-ImageReferenceOffer

映像产品/服务（如果适用）。

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

-ImageReferencePublisher

映像发布者

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

-ImageReferenceSku

映像 SKU

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

-ImageReferenceVersion

创建时指定的映像版本。

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

-LabPlanId

实验室计划的 ID。 在资源创建期间用于提供默认值，并在通过 labs.azure.com 创建实验室时充当权限容器。 在现有实验室上设置 labPlanId 可提供组织。

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

-Location

资源所在的地理位置

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

-Name

唯一标识包含实验室帐户的实验室的名称。 在资源 URI 中使用。

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

-NetworkProfileLoadBalancerId

外部负载均衡器资源 ID

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

-NetworkProfilePublicIPId

外部公共 IP 资源 ID

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

-NetworkProfileSubnetId

外部子网资源 ID

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

-NonAdminUserPassword

用户的密码。 TemplateVM createOption 需要此项。

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

-NonAdminUserUsername

登录到实验室 VM 时要使用的用户名。

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

-NoWait

异步运行命令

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

-ResourceGroupName

资源组的名称。 名称不区分大小写。

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

-RosterProfileActiveDirectoryGroupId

从中填充此实验室名单的 AAD 组 ID。 设置后，将启用 AAD 同步模式。

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

-RosterProfileLmsInstance

标识 lms 实例的基本 URI。

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

-RosterProfileLtiClientId

lms 中 Azure 实验室服务工具的唯一 ID。

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

-RosterProfileLtiContextId

lms 中实验室的唯一上下文标识符。

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

-RosterProfileLtiRosterEndpoint

附加到此实验室的类的 lms 上名称和角色服务终结点的 URI。

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

-SecurityProfileOpenAccess

是任何用户还是仅指定用户可以注册到实验室。

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

-SkuCapacity

如果 SKU 支持横向扩展/缩减，则应包含容量整数。 如果资源无法横向扩展/缩小，则可能会省略此范围。

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

-SkuFamily

如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。

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

-SkuName

SKU 的名称。 Ex - P3. 它通常是字母+数字代码

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

-SkuSize

SKU 大小。 当名称字段是层和其他一些值的组合时，这将是独立的代码。

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

-SkuTier

如果服务具有多个层，但在 PUT 上不需要，则需要资源提供程序实现此字段。

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

-SubscriptionId

目标订阅的 ID。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-Tag

资源标记。

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

-Title

实验室的标题。

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

-VirtualMachineProfileCreateOption

指示从哪些实验室虚拟机创建。

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

-VirtualMachineProfileUsageQuota

分配给每个实验室用户的初始配额。 必须是介于 0 到 9999 小时之间的时间跨度。

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

-VirtualMachineProfileUseSharedPassword

启用此选项将对所有用户 VM 使用相同的密码。

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

-WhatIf

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

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

输出

ILab