Add-RdsAccount
Windows Sanal Masaüstü cmdlet istekleri için kullanılacak kimliği doğrulanmış bir hesap ekler.
Sözdizimi
Add-RdsAccount
[-DeploymentUrl] <String>
[[-Credential] <PSCredential>]
[<CommonParameters>]
Add-RdsAccount
[-DeploymentUrl] <String>
[-Credential] <PSCredential>
[-ServicePrincipal]
[-AadTenantId] <String>
[<CommonParameters>]
Add-RdsAccount
[-DeploymentUrl] <String>
[-CertificateThumbprint] <String>
[-ApplicationId] <String>
[-AadTenantId] <String>
[<CommonParameters>]
Description
Add-RdsAccount cmdlet'i, Windows Sanal Masaüstü cmdlet istekleri için kullanılacak kimliği doğrulanmış bir hesap ekler. Tamamlandığında, bağlam otomatik olarak kiracı grubu adı olarak "Varsayılan Kiracı Grubu" kullanacak şekilde ayarlanır. bağlamı değiştirmek için Set-RdsContext cmdlet'ini çalıştırabilirsiniz.
Örnekler
Örnek 1: Etkileşimli oturum açma bilgileri aracılığıyla Windows Sanal Masaüstü'ne bağlanma
PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
DeploymentUrl TenantGroupName UserName
------------- --------------- --------
https://rdbroker.wvd.microsoft.com Default Tenant Group admin@contoso.com
Bu komut bir iş veya okul hesabına bağlanır. Windows Sanal Masaüstü cmdlet'lerini bu hesapla çalıştırmak için, istemde 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
`powershell
PS C:\> $Credential = Get-Credential
PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
DeploymentUrl TenantGroupName UserName
------------- --------------- --------
https://rdbroker.wvd.microsoft.com Default Tenant Group admin@contoso.com
' İlk komut kullanıcı kimlik bilgilerini (kullanıcı adı ve parola) ister ve bunları $Credential değişkeninde depolar. İkinci komut, $Credential'de 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
`powershell
PS C:\> $Credential = Get-Credential
PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com" -ServicePrincipal -AadTenantId "xxxx-xxxx-xxxx-xxxx"
DeploymentUrl TenantGroupName UserName
------------- --------------- --------
https://rdbroker.wvd.microsoft.com Default Tenant Group admin@contoso.com
' İlk komut hizmet sorumlusu kimlik bilgilerini (Uygulama Kimliği ve hizmet sorumlusu gizli dizisi) alır ve bunları $Credential değişkeninde depolar. İkinci komut, belirtilen Kiracı için $Credential depolanan hizmet sorumlusu kimlik bilgilerini kullanarak Azure AD hesabına bağlanır. ServicePrincipal anahtar parametresi, hesabın hizmet sorumlusu olarak kimlik doğrulamasından geçtiğini gösterir.
Örnek 4: Sertifika kimlik bilgileriyle 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 = "4cd76576-b611-43d0-8f2b-adcb139531bf"
PS C:\> $ApplicationId = "3794a65a-e4e4-493d-ac1d-f04308d712dd"
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 üye olduğu Azure AD kiracı kimliğini belirtir.
Tür: | String |
Diğer adlar: | TenantId |
Position: | 3 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ApplicationId
Windows Sanal Masaüstü'nde kimlik doğrulaması için hizmet sorumlusunun uygulama kimliği.
Tür: | String |
Position: | 2 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-CertificateThumbprint
Windows Sanal Masaüstü'nde hizmet sorumlusu olarak kimlik doğrulaması yapmak için yüklü sertifikanın parmak izi.
Tür: | String |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Credential
PSCredential nesnesini belirtir. PSCredential nesnesi hakkında daha fazla bilgi için Get-Credential Get-Help 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.
Tür: | PSCredential |
Position: | 1 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-DeploymentUrl
Windows Sanal Masaüstü yönetim sitesini işaret eden Evrensel Kaynak Bulucu (URL) dizesi.
Tür: | String |
Position: | 0 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ServicePrincipal
Bu hesabın hizmet sorumlusu kimlik bilgilerini sağlayarak kimlik doğrulamasını belirten anahtar.
Tür: | SwitchParameter |
Position: | 2 |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
Girişler
None
Çıkışlar
Microsoft.RDInfra.RDManagementData.RdMgmtContext