Add-RdsAccount cmdlet'i, Windows Sanal Masaüstü cmdlet istekleri için kullanmak üzere kimliği doğrulanmış bir hesap ekler. Tamamlandıktan sonra bağlam, kiracı grubu adı olarak "Varsayılan Kiracı Grubu"nu kullanacak şekilde otomatik olarak ayarlanır. Bağlamı değiştirmek için Set-RdsContext cmdlet'ini çalıştırabilirsiniz.
Örnekler
Örnek 1: Etkileşimli oturum açma aracılığıyla Windows Sanal Masaüstü'ne bağlanma
Bu komut bir iş veya okul hesabına bağlanır. Windows Sanal Masaüstü cmdlet'lerini bu hesapla çalıştırmak için, komut isteminde kuruluş kimliği kimlik bilgilerini sağlamanız gerekir. Kimlik bilgileriniz için çok faktörlü kimlik doğrulaması etkinleştirildiyse, etkileşimli seçeneği kullanarak oturum açmanız veya hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.
Örnek 2: Kuruluş kimliği kimlik bilgilerini kullanarak Windows Sanal Masaüstü'ne bağlanma
İlk komut, kullanıcı kimlik bilgilerini (kullanıcı adı ve parola) ister ve ardından bunları $Credential değişkeninde saklar. İkinci komut, $Credential'da depolanan kimlik bilgilerini kullanarak Azure AD hesabına bağlanır. Bu hesap, kuruluş kimliği kimlik bilgilerini kullanarak Windows Sanal Masaüstü ile kimlik doğrulaması yapar. Kimlik bilgileriniz için çok faktörlü kimlik doğrulaması etkinleştirildiyse, etkileşimli seçeneği kullanarak oturum açmanız veya hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.
Örnek 3: Parola kimlik bilgileriyle bir hizmet sorumlusu hesabı kullanarak Windows Sanal Masaüstü'ne bağlanma
İlk komut, hizmet sorumlusu kimlik bilgilerini (Uygulama Kimliği ve hizmet sorumlusu gizli anahtarı) alır ve ardından bunları $Credential değişkeninde depolar. İkinci komut, belirtilen kiracı için $Credential'da depolanan hizmet sorumlusu kimlik bilgilerini kullanarak Azure AD hesabına bağlanır. ServicePrincipal anahtar parametresi, hesabın hizmet sorumlusu olarak kimlik doğrulamasını gösterir.
Örnek 4: Sertifika kimlik bilgileriyle bir hizmet sorumlusu hesabı kullanarak Windows Sanal Masaüstü'ne bağlanma
# 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
Parametreler
-AadTenantId
Hizmet sorumlusunun üyesi olduğu Azure AD kiracı kimliğini belirtir.
Parametre özellikleri
Tür:
String
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Diğer adlar:
KiracıID
Parametre kümeleri
AddAccountWithServicePrincipal
Position:
3
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
AddAccountWithThumbprint
Position:
3
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
-ApplicationId
Windows Sanal Masaüstü'nde kimlik doğrulaması yapmak için hizmet sorumlusunun uygulama kimliği.
Parametre özellikleri
Tür:
String
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Parametre kümeleri
AddAccountWithThumbprint
Position:
2
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
-CertificateThumbprint
Windows Sanal Masaüstü'nde hizmet sorumlusu olarak kimlik doğrulaması yapmak için yüklü sertifikanın parmak izi.
Parametre özellikleri
Tür:
String
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Parametre kümeleri
AddAccountWithThumbprint
Position:
1
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
-Credential
PSCredential nesnesini belirtir. PSCredential nesnesi hakkında daha fazla bilgi için Get-Help Get-Credential yazın. PSCredential nesnesi, kuruluş kimliği kimlik bilgileri için kullanıcı kimliği ve parola ya da hizmet sorumlusu kimlik bilgileri için uygulama kimliği ve gizli dizi sağlar.
Parametre özellikleri
Tür:
PSCredential
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Parametre kümeleri
AddAccountWithCredential
Position:
1
Zorunlu:
False
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
-DeploymentUrl
Windows Sanal Masaüstü yönetim sitesine işaret eden Evrensel Kaynak Konum Belirleyicisi (URL) dizesi.
Parametre özellikleri
Tür:
String
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Parametre kümeleri
(All)
Position:
0
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
-ServicePrincipal
Bu hesabın hizmet sorumlusu kimlik bilgilerini sağlayarak kimlik doğrulaması yaptığını belirten anahtar.
Parametre özellikleri
Tür:
SwitchParameter
Default value:
None
Joker karakterleri destekler:
False
DontShow:
False
Parametre kümeleri
AddAccountWithServicePrincipal
Position:
2
Zorunlu:
True
İşlem hattından gelen değer:
False
Özellik adına göre işlem hattından gelen değer:
False
Kalan bağımsız değişkenlerden elde edilen değer:
False
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.