Dela via


New-AzLabServicesLab

Åtgärd för att skapa en labbresurs.

Syntax

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

Åtgärd för att skapa en labbresurs.

Exempel

Exempel 1: Skapa ett nytt labb.

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

Skapar ett nytt labb.

Parametrar

-AdditionalCapabilityInstallGpuDriver

Flagga för att installera dedikerade GPU-drivrutiner i förväg.

Typ:EnableState
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AdminUserPassword

Ange lösenordet för användaren. Detta krävs för TemplateVM createOption.

Typ:SecureString
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AdminUserUsername

Användarnamnet som ska användas när du loggar in på virtuella labbdatorer.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AsJob

Kör kommandot som ett jobb

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileDisconnectDelay

Hur lång tid en virtuell dator fortsätter att köras när en användare kopplar från om det här beteendet är aktiverat.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileIdleDelay

Hur lång tid en virtuell dator kommer att inaktiva innan den stängs av om det här beteendet är aktiverat.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileNoConnectDelay

Hur lång tid en virtuell dator kommer att fortsätta att köras innan den stängs av om ingen anslutning görs och det här beteendet är aktiverat.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileShutdownOnDisconnect

Om avstängning vid frånkoppling är aktiverat

Typ:EnableState
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileShutdownOnIdle

Om en virtuell dator kommer att stängas av när den har varit inaktiv under en viss tid.

Typ:ShutdownOnIdleMode
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoShutdownProfileShutdownWhenNotConnected

Om en virtuell dator kommer att stängas av när den inte har anslutits till efter en viss tid.

Typ:EnableState
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionProfileClientRdpAccess

Den aktiverade åtkomstnivån för klientåtkomst via RDP.

Typ:ConnectionType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionProfileClientSshAccess

Den aktiverade åtkomstnivån för klientåtkomst via SSH.

Typ:ConnectionType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionProfileWebRdpAccess

Den aktiverade åtkomstnivån för webbåtkomst via RDP.

Typ:ConnectionType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConnectionProfileWebSshAccess

Den aktiverade åtkomstnivån för webbåtkomst via SSH.

Typ:ConnectionType
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Beskrivningen av labbet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferenceId

Avbildningsresurs-ID

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferenceOffer

Bilderbjudandet om tillämpligt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferencePublisher

Bildutgivaren

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferenceSku

Avbildningens SKU

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ImageReferenceVersion

Den avbildningsversion som angavs när den skapades.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-LabPlanId

ID för labbplanen. Används när resursen skapas för att tillhandahålla standardvärden och fungerar som en behörighetscontainer när du skapar ett labb via labs.azure.com. Att ange ett labPlanId på ett befintligt labb tillhandahåller organisation..

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Den geo-plats där resursen finns

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på labbet som unikt identifierar det i ett labbkonto. Används i resurs-URI:er.

Typ:String
Alias:LabName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NetworkProfileLoadBalancerId

Resurs-ID för extern lastbalanserare

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NetworkProfilePublicIPId

Det externa offentliga IP-resurs-ID:t

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NetworkProfileSubnetId

Resurs-ID för det externa undernätet

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NonAdminUserPassword

Ange lösenordet för användaren. Detta krävs för TemplateVM createOption.

Typ:SecureString
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NonAdminUserUsername

Användarnamnet som ska användas när du loggar in på virtuella labbdatorer.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoWait

Kör kommandot asynkront

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RosterProfileActiveDirectoryGroupId

AAD-grupp-ID:t som den här labblistan fylls i från. Med den här uppsättningen aktiverar du AAD-synkroniseringsläge.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RosterProfileLmsInstance

Bas-URI:n som identifierar lms-instansen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RosterProfileLtiClientId

Det unika ID:t för azure lab services-verktyget i lms.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RosterProfileLtiContextId

Den unika kontextidentifieraren för labbet i lms.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RosterProfileLtiRosterEndpoint

URI för tjänstslutpunkten för namn och roller i lms för klassen som är kopplad till den här labbuppgiften.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SecurityProfileOpenAccess

Om någon användare eller endast angivna användare kan registrera sig i ett labb.

Typ:EnableState
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuCapacity

Om SKU:n stöder utskalning/in bör kapacitets heltal inkluderas. Om det inte går att skala ut/in för resursen kan detta utelämnas.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuFamily

Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuName

Namnet på SKU:n. Ex - P3. Det är vanligtvis en bokstav+nummerkod

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuSize

SKU-storleken. När namnfältet är kombinationen av nivå och något annat värde är detta den fristående koden.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuTier

Det här fältet måste implementeras av resursprovidern om tjänsten har mer än en nivå, men inte krävs på en PUT.

Typ:SkuTier
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

ID för målprenumerationen.

Typ:String
Position:Named
Standardvärde:(Get-AzContext).Subscription.Id
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Resurstaggar.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Title

Labbtiteln.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualMachineProfileCreateOption

Anger vilka virtuella labbdatorer som skapas från.

Typ:CreateOption
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualMachineProfileUsageQuota

Den första kvoten tilldelad till varje labbanvändare. Måste vara ett tidsintervall mellan 0 och 9999 timmar.

Typ:TimeSpan
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VirtualMachineProfileUseSharedPassword

Om du aktiverar det här alternativet används samma lösenord för alla virtuella användardatorer.

Typ:EnableState
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

ILab