Add-RdsAccount cmdlet은 Windows Virtual Desktop cmdlet 요청에 사용할 인증된 계정을 추가합니다. 완료되면 컨텍스트가 "기본 테넌트 그룹"을 테넌트 그룹 이름으로 사용하도록 자동으로 설정됩니다. Set-RdsContext cmdlet을 실행하여 컨텍스트를 변경할 수 있습니다.
이 명령은 회사 또는 학교 계정에 연결합니다. 이 계정으로 Windows Virtual Desktop cmdlet을 실행하려면 프롬프트에서 조직 ID 자격 증명을 제공해야 합니다. 자격 증명에 다단계 인증을 사용하는 경우 대화형 옵션을 사용하여 로그인하거나 서비스 주체 인증을 사용해야 합니다.
예제 2: 조직 ID 자격 증명을 사용하여 Windows Virtual Desktop에 연결
첫 번째 명령은 사용자 자격 증명(사용자 이름 및 암호)을 묻는 메시지를 표시한 다음 $Credential 변수에 저장합니다. 두 번째 명령은 $Credential에 저장된 자격 증명을 사용하여 Azure AD 계정에 연결합니다. 이 계정은 조직 ID 자격 증명을 사용하여 Windows Virtual Desktop으로 인증합니다. 자격 증명에 다단계 인증을 사용하는 경우 대화형 옵션을 사용하여 로그인하거나 서비스 주체 인증을 사용해야 합니다.
예제 3: 암호 자격 증명이 있는 서비스 주체 계정을 사용하여 Windows Virtual Desktop에 연결
첫 번째 명령은 서비스 주체 자격 증명(애플리케이션 ID 및 서비스 주체 비밀)을 가져온 다음 $Credential 변수에 저장합니다. 두 번째 명령은 지정된 테넌트에 대해 $Credential에 저장된 서비스 주체 자격 증명을 사용하여 Azure AD 계정에 연결합니다. ServicePrincipal 스위치 매개 변수는 계정이 서비스 주체로 인증됨을 나타냅니다.
예제 4: 인증서 자격 증명이 있는 서비스 주체 계정을 사용하여 Windows Virtual Desktop에 연결
# For more information on creating a self-signed certificate
# and giving it proper permissions, please see the following:
# https://learn.microsoft.com/azure/active-directory/develop/howto-authenticate-service-principal-powershell
PS C:\> $Thumbprint = "0SZTNJ34TCCMUJ5MJZGR8XQD3S0RVHJBA33Z8ZXV"
PS C:\> $TenantId = "aaaabbbb-0000-cccc-1111-dddd2222eeee"
PS C:\> $ApplicationId = "00001111-aaaa-2222-bbbb-3333cccc4444"
PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com" -CertificateThumbprint $Thumbprint -ApplicationId $ApplicationId -AadTenantId $TenantId
DeploymentUrl TenantGroupName UserName
------------- --------------- --------
https://rdbroker.wvd.microsoft.com Default Tenant Group admin@contoso.com
매개 변수
-AadTenantId
서비스 주체가 멤버인 Azure AD 테넌트 ID를 지정합니다.
매개 변수 속성
형식:
String
Default value:
None
와일드카드 지원:
False
DontShow:
False
별칭:
테넌트아이디
매개 변수 집합
AddAccountWithServicePrincipal
Position:
3
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
AddAccountWithThumbprint
Position:
3
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
-ApplicationId
Windows Virtual Desktop에 인증할 서비스 주체의 애플리케이션 ID입니다.
매개 변수 속성
형식:
String
Default value:
None
와일드카드 지원:
False
DontShow:
False
매개 변수 집합
AddAccountWithThumbprint
Position:
2
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
-CertificateThumbprint
Windows Virtual Desktop에 대한 서비스 주체로 인증하기 위한 설치된 인증서의 지문입니다.
매개 변수 속성
형식:
String
Default value:
None
와일드카드 지원:
False
DontShow:
False
매개 변수 집합
AddAccountWithThumbprint
Position:
1
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
-Credential
PSCredential 개체를 지정합니다. PSCredential 개체에 대한 자세한 내용은 Get-Help Get-Credential을 입력합니다. PSCredential 개체는 조직 ID 자격 증명에 대한 사용자 ID 및 암호 또는 서비스 주체 자격 증명에 대한 애플리케이션 ID 및 비밀을 제공합니다.
매개 변수 속성
형식:
PSCredential
Default value:
None
와일드카드 지원:
False
DontShow:
False
매개 변수 집합
AddAccountWithCredential
Position:
1
필수:
False
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
-DeploymentUrl
Windows Virtual Desktop 관리 사이트를 가리키는 URL(Universal Resource Locator) 문자열입니다.
매개 변수 속성
형식:
String
Default value:
None
와일드카드 지원:
False
DontShow:
False
매개 변수 집합
(All)
Position:
0
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
-ServicePrincipal
이 계정이 서비스 주체 자격 증명을 제공하여 인증함을 나타내는 스위치입니다.
매개 변수 속성
형식:
SwitchParameter
Default value:
None
와일드카드 지원:
False
DontShow:
False
매개 변수 집합
AddAccountWithServicePrincipal
Position:
2
필수:
True
파이프라인의 값:
False
속성 이름별 파이프라인의 값:
False
나머지 인수의 값:
False
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.