New-AzLabServicesLab
Opération de création d’une ressource lab.
Syntaxe
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
Opération de création d’une ressource lab.
Exemples
Exemple 1 : Créer un laboratoire.
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 NewLabCrée un laboratoire.
Paramètres
-AdditionalCapabilityInstallGpuDriver
Indicateur pour préinstaller les pilotes GPU dédiés.
| Type: | EnableState |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AdminUserPassword
Mot de passe de l’utilisateur. Cela est requis pour templateVM createOption.
| Type: | SecureString |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AdminUserUsername
Nom d’utilisateur à utiliser lors de la connexion aux machines virtuelles lab.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AsJob
Exécuter la commande en tant que travail
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileDisconnectDelay
Durée pendant laquelle une machine virtuelle reste en cours d’exécution après qu’un utilisateur se déconnecte si ce comportement est activé.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileIdleDelay
Durée d’inactivité d’une machine virtuelle avant son arrêt si ce comportement est activé.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileNoConnectDelay
Durée pendant laquelle une machine virtuelle reste en cours d’exécution avant son arrêt si aucune connexion n’est établie et que ce comportement est activé.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileShutdownOnDisconnect
Indique si l’arrêt lors de la déconnexion est activé
| Type: | EnableState |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileShutdownOnIdle
Indique si une machine virtuelle est arrêtée lorsqu’elle est inactive pendant une période de temps.
| Type: | ShutdownOnIdleMode |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-AutoShutdownProfileShutdownWhenNotConnected
Indique si une machine virtuelle est arrêtée lorsqu’elle n’a pas été connectée après une période donnée.
| Type: | EnableState |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
| Type: | SwitchParameter |
| Alias: | cf |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConnectionProfileClientRdpAccess
Niveau d’accès activé pour l’accès client via RDP.
| Type: | ConnectionType |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConnectionProfileClientSshAccess
Niveau d’accès activé pour l’accès client via SSH.
| Type: | ConnectionType |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConnectionProfileWebRdpAccess
Niveau d’accès activé pour l’accès web via RDP.
| Type: | ConnectionType |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ConnectionProfileWebSshAccess
Niveau d’accès activé pour l’accès web via SSH.
| Type: | ConnectionType |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
| Type: | PSObject |
| Alias: | AzureRMContext, AzureCredential |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Description
Description du labo.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImageReferenceId
ID de ressource d’image
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImageReferenceOffer
Offre d’image le cas échéant.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImageReferencePublisher
Éditeur d’images
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImageReferenceSku
Référence SKU d’image
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ImageReferenceVersion
Version d’image spécifiée lors de la création.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-LabPlanId
ID du plan de laboratoire. Utilisé lors de la création de ressources pour fournir des valeurs par défaut et sert de conteneur d’autorisations lors de la création d’un labo via labs.azure.com. La définition d’un labPlanId sur un laboratoire existant fournit une organisation..
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Location
Emplacement géographique où réside la ressource
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Name
Nom du labo qui l’identifie de manière unique au sein du compte lab contenant. Utilisé dans les URI de ressource.
| Type: | String |
| Alias: | LabName |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NetworkProfileLoadBalancerId
ID de ressource de l’équilibreur de charge externe
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NetworkProfilePublicIPId
ID de ressource IP publique externe
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NetworkProfileSubnetId
ID de ressource de sous-réseau externe
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NonAdminUserPassword
Mot de passe de l’utilisateur. Cela est requis pour templateVM createOption.
| Type: | SecureString |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NonAdminUserUsername
Nom d’utilisateur à utiliser lors de la connexion aux machines virtuelles lab.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-NoWait
Exécuter la commande de manière asynchrone
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-ResourceGroupName
Nom du groupe de ressources. Le nom ne respecte pas la casse.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RosterProfileActiveDirectoryGroupId
ID de groupe AAD à partir duquel cette liste de laboratoires est remplie. Ce jeu active le mode de synchronisation AAD.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RosterProfileLmsInstance
URI de base identifiant l’instance lms.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RosterProfileLtiClientId
ID unique de l’outil azure Lab Services dans les lms.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RosterProfileLtiContextId
Identificateur de contexte unique pour le labo dans les lms.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RosterProfileLtiRosterEndpoint
URI des noms et des rôles de point de terminaison de service sur les lms de la classe attachée à ce labo.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SecurityProfileOpenAccess
Indique si un utilisateur ou uniquement des utilisateurs spécifiés peuvent s’inscrire à un laboratoire.
| Type: | EnableState |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkuCapacity
Si la référence SKU prend en charge le scale-out/in, l’entier de capacité doit être inclus. Si le scale-out/in n’est pas possible pour la ressource, cela peut être omis.
| Type: | Int32 |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkuFamily
Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkuName
Nom de la référence SKU. Ex - P3. Il s’agit généralement d’une lettre+code numérique
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkuSize
Taille de la référence SKU. Lorsque le champ de nom est la combinaison de niveau et d’une autre valeur, il s’agit du code autonome.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SkuTier
Ce champ doit être implémenté par le fournisseur de ressources si le service a plusieurs niveaux, mais n’est pas obligatoire sur un PUT.
| Type: | SkuTier |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SubscriptionId
ID de l’abonnement cible.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | (Get-AzContext).Subscription.Id |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Tag
Balises de ressource.
| Type: | Hashtable |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-Title
Titre du labo.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualMachineProfileCreateOption
Indique les machines virtuelles du labo à partir de laquelle sont créées.
| Type: | CreateOption |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualMachineProfileUsageQuota
Quota initial alloué à chaque utilisateur lab. Doit être un intervalle de temps compris entre 0 et 9999 heures.
| Type: | TimeSpan |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VirtualMachineProfileUseSharedPassword
L’activation de cette option utilise le même mot de passe pour toutes les machines virtuelles utilisateur.
| Type: | EnableState |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
| Type: | SwitchParameter |
| Alias: | wi |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
Sorties
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour