Add-RdsAccount

参考

模块:: WindowsVirtualDesktopPowershell

添加用于 Windows 虚拟桌面 cmdlet 请求的经过身份验证的帐户。

语法

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>]

说明

Add-RdsAccount cmdlet 添加了用于 Windows 虚拟桌面 cmdlet 请求的经过身份验证的帐户。完成后，上下文会自动设置为使用“默认租户组”作为租户组名称。可以运行 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 虚拟桌面

`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

“第一个命令将提示输入用户凭据（用户名和密码），然后将其存储在$Credential变量中。第二个命令使用存储在$Credential中的凭据连接到 Azure AD 帐户。此帐户使用组织 ID 凭据通过 Windows 虚拟桌面进行身份验证。如果为凭据启用了多重身份验证，则必须使用交互式选项登录或使用服务主体身份验证。

示例 3：使用具有密码凭据的服务主体帐户连接到 Windows 虚拟桌面

`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

第一个命令获取服务主体凭据（应用程序 ID 和服务主体机密），然后将其存储在$Credential变量中。第二个命令使用存储在指定租户$Credential中的服务主体凭据连接到 Azure AD 帐户。 ServicePrincipal switch 参数指示帐户作为服务主体进行身份验证。

示例 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 = "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

参数

-AadTenantId

指定服务主体所属的 Azure AD 租户 ID。

类型:	String
别名:	TenantId
Position:	3
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ApplicationId

要向 Windows 虚拟桌面进行身份验证的服务主体的应用程序 ID。

类型:	String
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-CertificateThumbprint

要作为 Windows 虚拟桌面的服务主体进行身份验证的已安装证书的指纹。

类型:	String
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Credential

指定 PSCredential 对象。有关 PSCredential 对象的详细信息，请键入 Get-Help Get-Credential。 PSCredential 对象提供组织 ID 凭据的用户 ID 和密码，或服务主体凭据的应用程序 ID 和机密。

类型:	PSCredential
Position:	1
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DeploymentUrl

指向 Windows 虚拟桌面管理站点的通用资源定位符（URL）字符串。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ServicePrincipal

开关指示此帐户通过提供服务主体凭据进行身份验证。

类型:	SwitchParameter
Position:	2
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

输入

None

输出

Microsoft.RDInfra.RDManagementData.RdMgmtContext

通过