Add-RdsAccount
添加經過身份驗證的帳戶以用於 Windows 虛擬桌面 cmdlet 請求。
語法
AddAccountWithCredential (預設值)
Add-RdsAccount
[-DeploymentUrl] <String>
[[-Credential] <PSCredential>]
[<CommonParameters>]
AddAccountWithServicePrincipal
Add-RdsAccount
[-DeploymentUrl] <String>
[-Credential] <PSCredential>
[-AadTenantId] <String>
[-ServicePrincipal]
[<CommonParameters>]
AddAccountWithThumbprint
Add-RdsAccount
[-DeploymentUrl] <String>
[-CertificateThumbprint] <String>
[-ApplicationId] <String>
[-AadTenantId] <String>
[<CommonParameters>]
Description
Add-RdsAccount cmdlet 添加一個經過身份驗證的帳戶，用於 Windows 虛擬桌面 cmdlet 請求。 完成後，上下文將自動設置為使用 “Default Tenant Group” 作為租戶組名稱。 您可以執行 Set-RdsContext cmdlet 來更改上下文。
範例
範例 1：透過互動式登錄連接到 Windows 虛擬桌面
PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"
DeploymentUrl TenantGroupName UserName
------------- --------------- --------
https://rdbroker.wvd.microsoft.com Default Tenant Group admin@contoso.com
此命令連接到工作或學校帳戶。 要使用此帳戶運行 Windows 虛擬桌面 cmdlet，必須在提示符處提供組織 ID 憑據。 如果您的認證已啟用多重要素驗證，您必須使用互動式選項或使用服務主體驗證來登入。
範例 2：使用組織 ID 憑據連接到 Windows 虛擬桌面
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
第一個命令將提示輸入使用者憑據 （username 和 password），然後將它們存儲在 $Credential 變數中。 第二個命令使用存儲在 $Credential 中的憑據連接到 Azure AD 帳戶。 此帳戶使用組織ID憑據對Windows虛擬桌面進行身份驗證。 如果您的認證已啟用多重要素驗證，您必須使用互動式選項或使用服務主體驗證來登入。
示例 3：使用具有密碼憑據的服務主體帳戶連接到 Windows 虛擬桌面
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
第一個命令獲取服務主體憑據（應用程式 ID 和服務主體機密），然後將它們存儲在 $Credential 變數中。 第二個命令使用存儲在指定 Tenant 的 $Credential 中的服務主體憑據連接到 Azure AD 帳戶。 ServicePrincipal 參數表示帳戶會驗證為服務主體。
範例 4：使用具有證書憑據的服務主體帳戶連接到 Windows 虛擬桌面
# 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
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 租戶識別碼 (TenantId) |
參數集
AddAccountWithServicePrincipal
| Position: | 3 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
AddAccountWithThumbprint
| Position: | 3 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ApplicationId
用於向 Windows 虛擬桌面進行身份驗證的服務主體的應用程式 ID。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AddAccountWithThumbprint
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-CertificateThumbprint
已安裝證書的指紋，用於作為 Windows 虛擬桌面的服務主體進行身份驗證。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AddAccountWithThumbprint
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定 PSCredential 物件。 如需 PSCredential 物件的詳細資訊，請輸入 Get-Help Get-Credential。 PSCredential 物件會提供組織標識符認證的使用者標識碼和密碼，或服務主體認證的應用程式標識碼和秘密。
參數屬性
| 類型: | PSCredential
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AddAccountWithCredential
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DeploymentUrl
指向 Windows 虛擬桌面管理網站的通用資源定位器 （URL） 字串。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ServicePrincipal
switch 指示此帳戶通過提供服務主體憑證進行身份驗證。
參數屬性
| 類型: | SwitchParameter
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
AddAccountWithServicePrincipal
| Position: | 2 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
None
輸出
Microsoft.RDInfra.RDManagementData.RdMgmtContext