New-AzLabServicesLab
Operación para crear un recurso de laboratorio.
Sintaxis
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>]
Description
Operación para crear un recurso de laboratorio.
Ejemplos
Ejemplo 1: Crear un laboratorio.
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
Crea un laboratorio.
Parámetros
-AdditionalCapabilityInstallGpuDriver
Marca para instalar previamente controladores de GPU dedicados.
Tipo: | EnableState |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AdminUserPassword
Contraseña del usuario. Esto es necesario para TemplateVM createOption.
Tipo: | SecureString |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AdminUserUsername
Nombre de usuario que se va a usar al iniciar sesión en máquinas virtuales de laboratorio.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AsJob
Ejecución del comando como trabajo
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileDisconnectDelay
La cantidad de tiempo que una máquina virtual permanecerá ejecutándose después de que un usuario se desconecte si este comportamiento está habilitado.
Tipo: | TimeSpan |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileIdleDelay
La cantidad de tiempo que una máquina virtual estará inactiva antes de que se apague si este comportamiento está habilitado.
Tipo: | TimeSpan |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileNoConnectDelay
La cantidad de tiempo que una máquina virtual permanecerá ejecutándose antes de que se cierre si no se realiza ninguna conexión y este comportamiento está habilitado.
Tipo: | TimeSpan |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileShutdownOnDisconnect
Indica si el apagado en la desconexión está habilitado
Tipo: | EnableState |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileShutdownOnIdle
Si una máquina virtual se apagará cuando se haya inactivo durante un período de tiempo.
Tipo: | ShutdownOnIdleMode |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-AutoShutdownProfileShutdownWhenNotConnected
Si una máquina virtual se apagará cuando no se haya conectado después de un período de tiempo.
Tipo: | EnableState |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Tipo: | SwitchParameter |
Alias: | cf |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ConnectionProfileClientRdpAccess
Nivel de acceso habilitado para el acceso de cliente a través de RDP.
Tipo: | ConnectionType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ConnectionProfileClientSshAccess
Nivel de acceso habilitado para el acceso de cliente a través de SSH.
Tipo: | ConnectionType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ConnectionProfileWebRdpAccess
Nivel de acceso habilitado para Acceso web a través de RDP.
Tipo: | ConnectionType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ConnectionProfileWebSshAccess
Nivel de acceso habilitado para El acceso web a través de SSH.
Tipo: | ConnectionType |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Tipo: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Description
Descripción del laboratorio.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageReferenceId
Id. de recurso de imagen
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageReferenceOffer
Oferta de imagen si procede.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageReferencePublisher
Publicador de imágenes
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageReferenceSku
SKU de imagen
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ImageReferenceVersion
Versión de la imagen especificada al crearse.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-LabPlanId
Identificador del plan de laboratorio. Se usa durante la creación de recursos para proporcionar valores predeterminados y actúa como un contenedor de permisos al crear un laboratorio a través de labs.azure.com. Establecer un labPlanId en un laboratorio existente proporciona organization..
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Location
Ubicación geográfica donde reside el recurso
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Nombre del laboratorio que lo identifica de forma única dentro de la cuenta de laboratorio contenedora. Se usa en los URI de recursos.
Tipo: | String |
Alias: | LabName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NetworkProfileLoadBalancerId
Identificador de recurso del equilibrador de carga externo
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NetworkProfilePublicIPId
Identificador de recurso de ip pública externa
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NetworkProfileSubnetId
Identificador de recurso de subred externo
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NonAdminUserPassword
Contraseña del usuario. Esto es necesario para TemplateVM createOption.
Tipo: | SecureString |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NonAdminUserUsername
Nombre de usuario que se va a usar al iniciar sesión en máquinas virtuales de laboratorio.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-NoWait
Ejecutar el comando de forma asincrónica
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-ResourceGroupName
Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RosterProfileActiveDirectoryGroupId
Identificador de grupo de AAD del que se rellena esta lista de laboratorio. Tener este conjunto habilita el modo de sincronización de AAD.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RosterProfileLmsInstance
URI base que identifica la instancia lms.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RosterProfileLtiClientId
Identificador único de la herramienta azure lab services en lms.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RosterProfileLtiContextId
Identificador de contexto único para el laboratorio en lms.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-RosterProfileLtiRosterEndpoint
El URI de los nombres y el punto de conexión de servicio de roles en lms para la clase adjunta a este laboratorio.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SecurityProfileOpenAccess
Si cualquier usuario o solo los usuarios especificados pueden registrarse en un laboratorio.
Tipo: | EnableState |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SkuCapacity
Si la SKU admite el escalado horizontal o horizontal, se debe incluir el entero de capacidad. Si no es posible escalar horizontalmente o reducir horizontalmente el recurso, se puede omitir.
Tipo: | Int32 |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SkuFamily
Si el servicio tiene diferentes generaciones de hardware, para la misma SKU, se puede capturar aquí.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SkuName
Nombre de la SKU. Por ejemplo, P3. Normalmente es un código de letra y número
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SkuSize
Tamaño de la SKU. Cuando el campo de nombre es la combinación de nivel y otro valor, este sería el código independiente.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SkuTier
El proveedor de recursos necesita implementar este campo si el servicio tiene más de un nivel, pero no es necesario en put.
Tipo: | SkuTier |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-SubscriptionId
Identificador de la suscripción de destino.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | (Get-AzContext).Subscription.Id |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Tag
Etiquetas de recursos.
Tipo: | Hashtable |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Title
Título del laboratorio.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VirtualMachineProfileCreateOption
Indica a partir de qué máquinas virtuales de laboratorio se crean.
Tipo: | CreateOption |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VirtualMachineProfileUsageQuota
Cuota inicial asignada a cada usuario de laboratorio. Debe ser un intervalo de tiempo comprendido entre 0 y 9999 horas.
Tipo: | TimeSpan |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-VirtualMachineProfileUseSharedPassword
Al habilitar esta opción, se usará la misma contraseña para todas las máquinas virtuales de usuario.
Tipo: | EnableState |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Tipo: | SwitchParameter |
Alias: | wi |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |