Cmdlet Add-RdsAccount menambahkan akun yang diautentikasi untuk digunakan untuk permintaan cmdlet Windows Virtual Desktop. Setelah selesai, konteks secara otomatis diatur untuk menggunakan "Grup Penyewa Default" sebagai nama grup penyewa. Anda dapat menjalankan cmdlet Set-RdsContext untuk mengubah konteks.
Contoh
Contoh 1: Menyambungkan ke Windows Virtual Desktop melalui login interaktif
Perintah ini terhubung ke akun kantor atau sekolah. Untuk menjalankan cmdlet Windows Virtual Desktop dengan akun ini, Anda harus memberikan kredensial ID organisasi saat diminta. Jika autentikasi multifaktor diaktifkan untuk kredensial Anda, Anda harus masuk menggunakan opsi interaktif atau menggunakan autentikasi perwakilan layanan.
Contoh 2: Menyambungkan ke Windows Virtual Desktop menggunakan kredensial ID organisasi
Perintah pertama akan meminta kredensial pengguna (nama pengguna dan kata sandi), lalu menyimpannya dalam variabel $Credential. Perintah kedua terhubung ke akun Azure Active Directory menggunakan kredensial yang disimpan di $Credential. Akun ini mengautentikasi dengan Windows Virtual Desktop menggunakan kredensial ID organisasi. Jika autentikasi multifaktor diaktifkan untuk kredensial Anda, Anda harus masuk menggunakan opsi interaktif atau menggunakan autentikasi perwakilan layanan.
Contoh 3: Menyambungkan ke Windows Virtual Desktop menggunakan akun perwakilan layanan dengan kredensial kata sandi
Perintah pertama mendapatkan kredensial perutamaan layanan (ID aplikasi dan rahasia perwakilan layanan), lalu menyimpannya dalam variabel $Credential. Perintah kedua terhubung ke akun Azure Active Directory menggunakan kredensial perwakilan layanan yang disimpan di $Credential untuk Penyewa yang ditentukan. Parameter sakelar ServicePrincipal menunjukkan bahwa akun mengautentikasi sebagai perwakilan layanan.
Contoh 4: Menyambungkan ke Windows Virtual Desktop menggunakan akun perwakilan layanan dengan kredensial sertifikat
# 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
Parameter
-AadTenantId
Menentukan ID penyewa Azure Active Directory tempat perwakilan layanan menjadi anggota.
Properti parameter
Jenis:
String
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Alias:
ID Penyewa
Set parameter
AddAccountWithServicePrincipal
Position:
3
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
AddAccountWithThumbprint
Position:
3
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-ApplicationId
ID aplikasi perwakilan layanan untuk mengautentikasi ke Windows Virtual Desktop.
Properti parameter
Jenis:
String
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
AddAccountWithThumbprint
Position:
2
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-CertificateThumbprint
Sidik jari untuk sertifikat yang diinstal untuk mengautentikasi sebagai perwakilan layanan ke Windows Virtual Desktop.
Properti parameter
Jenis:
String
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
AddAccountWithThumbprint
Position:
1
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-Credential
Menentukan objek PSCredential. Untuk informasi selengkapnya tentang objek PSCredential, ketik Get-Help Get-Credential. Objek PSCredential menyediakan ID pengguna dan kata sandi untuk kredensial ID organisasi, atau ID aplikasi dan rahasia untuk kredensial perwakilan layanan.
Properti parameter
Jenis:
PSCredential
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
AddAccountWithCredential
Position:
1
Wajib:
False
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-DeploymentUrl
String Universal Resource Locator (URL) yang menunjuk ke situs manajemen Windows Virtual Desktop.
Properti parameter
Jenis:
String
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
(All)
Position:
0
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
-ServicePrincipal
Beralih yang menunjukkan bahwa akun ini mengautentikasi dengan memberikan kredensial perwakilan layanan.
Properti parameter
Jenis:
SwitchParameter
Nilai default:
None
Mendukung wildcard:
False
DontShow:
False
Set parameter
AddAccountWithServicePrincipal
Position:
2
Wajib:
True
Nilai dari alur:
False
Nilai dari alur berdasarkan nama properti:
False
Nilai dari argumen yang tersisa:
False
CommonParameters
Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.