New-AzLabServicesLab
Vorgang zum Erstellen einer Lab-Ressource.
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>]
Beschreibung
Vorgang zum Erstellen einer Lab-Ressource.
Beispiele
Beispiel 1: Erstellen einer neuen Übung.
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
Erstellt ein neues Lab.
Parameter
-AdditionalCapabilityInstallGpuDriver
Kennzeichnen sie für dedizierte GPU-Treiber vor der Installation.
Typ: | EnableState |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AdminUserPassword
Das Kennwort für den Benutzer. Dies ist für die TemplateVM createOption erforderlich.
Typ: | SecureString |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AdminUserUsername
Der Benutzername, der beim Anmelden bei Lab-VMs verwendet werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AsJob
Ausführen des Befehls als Auftrag
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileDisconnectDelay
Der Zeitraum, in dem ein virtueller Computer ausgeführt wird, nachdem ein Benutzer die Verbindung getrennt hat, wenn dieses Verhalten aktiviert ist.
Typ: | TimeSpan |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileIdleDelay
Der Zeitraum, in dem ein virtueller Computer im Leerlauf ist, bevor er heruntergefahren wird, wenn dieses Verhalten aktiviert ist.
Typ: | TimeSpan |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileNoConnectDelay
Der Zeitraum, in dem ein virtueller Computer ausgeführt wird, bevor er heruntergefahren wird, wenn keine Verbindung hergestellt wird und dieses Verhalten aktiviert ist.
Typ: | TimeSpan |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileShutdownOnDisconnect
Gibt an, ob das Herunterfahren beim Trennen aktiviert ist.
Typ: | EnableState |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileShutdownOnIdle
Gibt an, ob ein virtueller Computer heruntergefahren wird, wenn er sich für einen bestimmten Zeitraum im Leerlauf befindet.
Typ: | ShutdownOnIdleMode |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AutoShutdownProfileShutdownWhenNotConnected
Gibt an, ob ein virtueller Computer heruntergefahren wird, wenn er nach einem bestimmten Zeitraum noch nicht verbunden wurde.
Typ: | EnableState |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConnectionProfileClientRdpAccess
Die aktivierte Zugriffsebene für den Clientzugriff über RDP.
Typ: | ConnectionType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConnectionProfileClientSshAccess
Die aktivierte Zugriffsebene für den Clientzugriff über SSH.
Typ: | ConnectionType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConnectionProfileWebRdpAccess
Die aktivierte Zugriffsebene für Web Access über RDP.
Typ: | ConnectionType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConnectionProfileWebSshAccess
Die aktivierte Zugriffsebene für Den Webzugriff über SSH.
Typ: | ConnectionType |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | PSObject |
Aliase: | AzureRMContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Description
Die Beschreibung des Labors.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ImageReferenceId
Bildressourcen-ID
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ImageReferenceOffer
Das Bildangebot, falls zutreffend.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ImageReferencePublisher
Der Bildherausgeber
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ImageReferenceSku
Bild-SKU
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ImageReferenceVersion
Die beim Erstellen angegebene Bildversion.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-LabPlanId
Die ID des Laborplans. Wird während der Ressourcenerstellung verwendet, um Standardeinstellungen bereitzustellen und beim Erstellen eines Labors über labs.azure.com als Berechtigungscontainer zu fungieren. Das Festlegen einer labPlanId für ein vorhandenes Lab stellt "organization." bereit.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Location
Der geografische Standort, an dem sich die Ressource befindet
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Name
Der Name des Labors, das es eindeutig innerhalb des Lab-Kontos identifiziert. Wird in Ressourcen-URIs verwendet.
Typ: | String |
Aliase: | LabName |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NetworkProfileLoadBalancerId
Die Ressourcen-ID des externen Lastenausgleichs
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NetworkProfilePublicIPId
Die id der externen öffentlichen IP-Ressource
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NetworkProfileSubnetId
Die ID der externen Subnetzressource
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NonAdminUserPassword
Das Kennwort für den Benutzer. Dies ist für die TemplateVM createOption erforderlich.
Typ: | SecureString |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NonAdminUserUsername
Der Benutzername, der beim Anmelden bei Lab-VMs verwendet werden soll.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-NoWait
Asynchrones Ausführen des Befehls
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RosterProfileActiveDirectoryGroupId
Die AAD-Gruppen-ID, aus der diese Lab-Liste aufgefüllt wird. Mit diesem Satz wird der AAD-Synchronisierungsmodus aktiviert.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RosterProfileLmsInstance
Der Basis-URI, der die lms-Instanz identifiziert.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RosterProfileLtiClientId
Die eindeutige ID des Azure Lab Services-Tools in den lms.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RosterProfileLtiContextId
Der eindeutige Kontextbezeichner für das Lab in den lms.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RosterProfileLtiRosterEndpoint
Der URI des Namens- und Rollendienstendpunkts für die an diese Übung angefügte Klasse.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SecurityProfileOpenAccess
Gibt an, ob ein Benutzer oder nur angegebene Benutzer sich bei einem Labor registrieren kann.
Typ: | EnableState |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SkuCapacity
Wenn die SKU skalierungs-/in unterstützt, sollte die Ganze Kapazität eingeschlossen werden. Wenn eine Skalierung für die Ressource nicht möglich ist, wird dies möglicherweise weggelassen.
Typ: | Int32 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SkuFamily
Wenn der Dienst über unterschiedliche Hardwaregenerationen verfügt, kann dies für dieselbe SKU hier erfasst werden.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SkuName
Der Name der SKU. Ex - P3. Es handelt sich in der Regel um einen Buchstaben+Zahlencode.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SkuSize
Die SKU-Größe. Wenn das Namensfeld die Kombination aus Ebene und einem anderen Wert ist, wäre dies der eigenständige Code.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SkuTier
Dieses Feld muss vom Ressourcenanbieter implementiert werden, wenn der Dienst mehr als eine Ebene aufweist, für einen PUT jedoch nicht erforderlich ist.
Typ: | SkuTier |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SubscriptionId
Hierbei handelt es sich um die ID des Zielabonnements.
Typ: | String |
Position: | Named |
Standardwert: | (Get-AzContext).Subscription.Id |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Tag
Ressourcentags.
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Title
Der Titel des Labors.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VirtualMachineProfileCreateOption
Gibt an, auf welchen virtuellen Laborcomputern virtuelle Computer erstellt werden.
Typ: | CreateOption |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VirtualMachineProfileUsageQuota
Das anfängliche Kontingent, das jedem Lab-Benutzer zugewiesen wurde. Muss eine Zeitspanne zwischen 0 und 9999 Stunden sein.
Typ: | TimeSpan |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-VirtualMachineProfileUseSharedPassword
Wenn Sie diese Option aktivieren, wird dasselbe Kennwort für alle Benutzer-VMs verwendet.
Typ: | EnableState |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Ausgaben
Azure PowerShell