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 开关参数指示帐户作为服务主体进行身份验证。

示例 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。

Type:	String
Aliases:	TenantId
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

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

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

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

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentUrl

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

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

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

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

Microsoft.RDInfra.RDManagementData.RdMgmtContext

通过