다음을 통해 공유


New-AzLabServicesLab

랩 리소스를 만드는 작업입니다.

구문

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

랩 리소스를 만드는 작업입니다.

예제

예제 1: 새 랩 만들기

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

새 랩을 만듭니다.

매개 변수

-AdditionalCapabilityInstallGpuDriver

전용 GPU 드라이버를 미리 설치하려면 플래그를 지정합니다.

형식:EnableState
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AdminUserPassword

사용자의 암호입니다. TemplateVM createOption에 필요합니다.

형식:SecureString
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AdminUserUsername

랩 VM에 로그인할 때 사용할 사용자 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AsJob

작업으로 명령 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileDisconnectDelay

이 동작을 사용하는 경우 사용자가 연결을 끊은 후 VM이 계속 실행되는 시간입니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileIdleDelay

이 동작을 사용하는 경우 VM이 종료되기 전에 유휴 상태로 전환되는 시간입니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileNoConnectDelay

연결이 수행되지 않고 이 동작을 사용하도록 설정된 경우 VM이 종료되기 전에 VM이 계속 실행되는 시간입니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileShutdownOnDisconnect

연결 끊기에서 종료를 사용할 수 있는지 여부

형식:EnableState
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileShutdownOnIdle

VM이 일정 기간 동안 유휴 상태일 때 종료되는지 여부입니다.

형식:ShutdownOnIdleMode
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AutoShutdownProfileShutdownWhenNotConnected

일정 기간 후에 VM이 연결되지 않은 경우 VM이 종료되는지 여부입니다.

형식:EnableState
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionProfileClientRdpAccess

RDP를 통해 클라이언트 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

형식:ConnectionType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionProfileClientSshAccess

SSH를 통해 클라이언트 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

형식:ConnectionType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionProfileWebRdpAccess

RDP를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

형식:ConnectionType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ConnectionProfileWebSshAccess

SSH를 통해 웹 액세스에 대해 사용하도록 설정된 액세스 수준입니다.

형식:ConnectionType
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:PSObject
별칭:AzureRMContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Description

랩에 대한 설명입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ImageReferenceId

이미지 리소스 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ImageReferenceOffer

해당하는 경우 이미지 제품입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ImageReferencePublisher

이미지 게시자

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ImageReferenceSku

이미지 SKU

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ImageReferenceVersion

만들 때 지정된 이미지 버전입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LabPlanId

랩 계획의 ID입니다. 리소스를 만드는 동안 기본값을 제공하고 labs.azure.com 통해 랩을 만들 때 권한 컨테이너 역할을 하는 데 사용됩니다. 기존 랩에서 labPlanId를 설정하면 조직이 제공됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Location

리소스가 있는 지리적 위치

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

포함하는 랩 계정 내에서 고유하게 식별하는 랩의 이름입니다. 리소스 URI에 사용됩니다.

형식:String
별칭:LabName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NetworkProfileLoadBalancerId

외부 부하 분산 장치 리소스 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NetworkProfilePublicIPId

외부 공용 IP 리소스 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NetworkProfileSubnetId

외부 서브넷 리소스 ID

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NonAdminUserPassword

사용자의 암호입니다. TemplateVM createOption에 필요합니다.

형식:SecureString
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NonAdminUserUsername

랩 VM에 로그인할 때 사용할 사용자 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NoWait

명령을 비동기적으로 실행

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RosterProfileActiveDirectoryGroupId

이 랩 명단이 채워지는 AAD 그룹 ID입니다. 이 집합을 사용하면 AAD 동기화 모드가 활성화됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RosterProfileLmsInstance

lms 인스턴스를 식별하는 기본 URI입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RosterProfileLtiClientId

lms에 있는 Azure Lab Services 도구의 고유 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RosterProfileLtiContextId

lms의 랩에 대한 고유 컨텍스트 식별자입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RosterProfileLtiRosterEndpoint

이 랩에 연결된 클래스의 lms에 있는 이름 및 역할 서비스 엔드포인트의 URI입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SecurityProfileOpenAccess

사용자 또는 지정된 사용자만 랩에 등록할 수 있는지 여부입니다.

형식:EnableState
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuCapacity

SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuFamily

서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuName

SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuSize

SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkuTier

이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.

형식:SkuTier
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SubscriptionId

대상 구독의 ID입니다.

형식:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tag

리소스 태그.

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Title

랩의 제목입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VirtualMachineProfileCreateOption

만들어진 랩 가상 머신을 나타냅니다.

형식:CreateOption
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VirtualMachineProfileUsageQuota

각 랩 사용자에게 할당된 초기 할당량입니다. 0~9999시간 사이의 시간 범위여야 합니다.

형식:TimeSpan
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VirtualMachineProfileUseSharedPassword

이 옵션을 사용하도록 설정하면 모든 사용자 VM에 동일한 암호가 사용됩니다.

형식:EnableState
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

출력

ILab