New-AzLabServicesLab
Operação para criar um recurso de laboratório.
Sintaxe
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
Operação para criar um recurso de laboratório.
Exemplos
Exemplo 1: criar um novo laboratório.
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 NewLabCria um novo Laboratório.
Parâmetros
-AdditionalCapabilityInstallGpuDriver
Sinalizar para pré-instalar drivers de GPU dedicados.
| Tipo: | EnableState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AdminUserPassword
A senha do usuário. Isso é necessário para o TemplateVM createOption.
| Tipo: | SecureString |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AdminUserUsername
O nome de usuário a ser usado ao entrar em VMs de laboratório.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AsJob
Executar o comando como um trabalho
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileDisconnectDelay
O tempo que uma VM permanecerá em execução depois que um usuário se desconectar se esse comportamento estiver habilitado.
| Tipo: | TimeSpan |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileIdleDelay
A quantidade de tempo que uma VM ficará ociosa antes de ser desligada se esse comportamento estiver habilitado.
| Tipo: | TimeSpan |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileNoConnectDelay
O tempo que uma VM permanecerá em execução antes de ser desligada se nenhuma conexão for feita e esse comportamento estiver habilitado.
| Tipo: | TimeSpan |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileShutdownOnDisconnect
Se o desligamento na desconexão está habilitado
| Tipo: | EnableState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileShutdownOnIdle
Se uma VM será desligada quando estiver ociosa por um período de tempo.
| Tipo: | ShutdownOnIdleMode |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AutoShutdownProfileShutdownWhenNotConnected
Se uma VM será desligada quando não tiver sido conectada após um período de tempo.
| Tipo: | EnableState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConnectionProfileClientRdpAccess
O nível de acesso habilitado para acesso ao cliente por RDP.
| Tipo: | ConnectionType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConnectionProfileClientSshAccess
O nível de acesso habilitado para acesso ao cliente por SSH.
| Tipo: | ConnectionType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConnectionProfileWebRdpAccess
O nível de acesso habilitado para Acesso à Web por RDP.
| Tipo: | ConnectionType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ConnectionProfileWebSshAccess
O nível de acesso habilitado para o Acesso à Web por SSH.
| Tipo: | ConnectionType |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
| Tipo: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
A descrição do laboratório.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ImageReferenceId
ID do recurso de imagem
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ImageReferenceOffer
A oferta de imagem, se aplicável.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ImageReferencePublisher
O editor de imagens
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ImageReferenceSku
A SKU da imagem
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ImageReferenceVersion
A versão da imagem especificada na criação.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-LabPlanId
A ID do plano de laboratório. Usado durante a criação de recursos para fornecer padrões e atua como um contêiner de permissão ao criar um laboratório por meio de labs.azure.com. A configuração de um labPlanId em um laboratório existente fornece organização..
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Location
A localização geográfica onde o recurso reside
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
O nome do laboratório que o identifica exclusivamente dentro da conta de laboratório que contém. Usado em URIs de recurso.
| Tipo: | String |
| Aliases: | LabName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NetworkProfileLoadBalancerId
A ID do recurso do balanceador de carga externo
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NetworkProfilePublicIPId
A ID do recurso de IP público externo
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NetworkProfileSubnetId
A ID do recurso de sub-rede externa
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NonAdminUserPassword
A senha do usuário. Isso é necessário para o TemplateVM createOption.
| Tipo: | SecureString |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NonAdminUserUsername
O nome de usuário a ser usado ao entrar em VMs de laboratório.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-NoWait
Executar o comando de forma assíncrona
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ResourceGroupName
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RosterProfileActiveDirectoryGroupId
A ID do grupo do AAD da qual esta lista de laboratórios é preenchida. Ter esse conjunto habilita o modo de sincronização do AAD.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RosterProfileLmsInstance
O URI base que identifica a instância lms.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RosterProfileLtiClientId
A ID exclusiva da ferramenta de serviços de laboratório do azure nos lms.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RosterProfileLtiContextId
O identificador de contexto exclusivo para o laboratório nos lms.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RosterProfileLtiRosterEndpoint
O uri dos nomes e funções do ponto de extremidade de serviço nos lms da classe anexada a este laboratório.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SecurityProfileOpenAccess
Se qualquer usuário ou apenas usuários especificados podem se registrar em um laboratório.
| Tipo: | EnableState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkuCapacity
Se o SKU der suporte a expansão/entrada, o inteiro de capacidade deverá ser incluído. Se a escala horizontal/in não for possível para o recurso, isso poderá ser omitido.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkuFamily
Se o serviço tiver diferentes gerações de hardware, para a mesma SKU, isso poderá ser capturado aqui.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkuName
O nome da SKU. Ex - P3. Normalmente, é um código letter+number
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkuSize
O tamanho da SKU. Quando o campo de nome é a combinação de camada e algum outro valor, esse seria o código autônomo.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SkuTier
Esse campo deverá ser implementado pelo Provedor de Recursos se o serviço tiver mais de uma camada, mas não for necessário em um PUT.
| Tipo: | SkuTier |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SubscriptionId
A ID da assinatura de destino.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | (Get-AzContext).Subscription.Id |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Tag
Marcas de recurso.
| Tipo: | Hashtable |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Title
O título do laboratório.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VirtualMachineProfileCreateOption
Indica de que máquinas virtuais de laboratório são criadas.
| Tipo: | CreateOption |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VirtualMachineProfileUsageQuota
A cota inicial alocada para cada usuário do laboratório. Deve ser um intervalo de tempo entre 0 e 9999 horas.
| Tipo: | TimeSpan |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VirtualMachineProfileUseSharedPassword
Habilitar essa opção usará a mesma senha para todas as VMs de usuário.
| Tipo: | EnableState |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
Azure PowerShell