Add-RdsAccount

Módulo:

WindowsVirtualDesktopPowershell

Adiciona uma conta autenticada a ser usada para solicitações de cmdlet da Área de Trabalho Virtual do Windows.

Sintaxe

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

O cmdlet Add-RdsAccount adiciona uma conta autenticada a ser usada para solicitações de cmdlet da Área de Trabalho Virtual do Windows. Após a conclusão, o contexto é automaticamente definido para usar o "Grupo de Locatários Padrão" como o nome do grupo de locatários. Você pode executar o cmdlet Set-RdsContext para alterar o contexto.

Exemplos

Exemplo 1: Conectar-se à Área de Trabalho Virtual do Windows por meio de um login interativo

PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"

DeploymentUrl                       TenantGroupName       UserName
-------------                       ---------------       --------
https://rdbroker.wvd.microsoft.com  Default Tenant Group  admin@contoso.com

Este comando liga-se a uma conta escolar ou profissional. Para executar cmdlets da Área de Trabalho Virtual do Windows com essa conta, você deve fornecer credenciais de ID organizacional no prompt. Se a autenticação multifator estiver habilitada para suas credenciais, você deverá efetuar login usando a opção interativa ou usar a autenticação da entidade de serviço.

Exemplo 2: Conectar-se à Área de Trabalho Virtual do Windows usando credenciais de ID organizacional

`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

' O primeiro comando solicitará credenciais de usuário (nome de usuário e senha) e, em seguida, armazená-las na variável $Credential. O segundo comando se conecta à conta do Azure AD usando as credenciais armazenadas no $Credential. Essa conta é autenticada na Área de Trabalho Virtual do Windows usando credenciais de ID organizacional. Se a autenticação multifator estiver habilitada para suas credenciais, você deverá efetuar login usando a opção interativa ou usar a autenticação da entidade de serviço.

Exemplo 3: Conectar-se à Área de Trabalho Virtual do Windows usando uma conta principal de serviço com credenciais de senha

`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

' O primeiro comando obtém as credenciais da entidade de serviço (ID do aplicativo e segredo da entidade de serviço) e, em seguida, armazena-as na variável $Credential. O segundo comando se conecta à conta do Azure AD usando as credenciais da entidade de serviço armazenadas no $Credential para o Locatário especificado. O parâmetro de opção ServicePrincipal indica que a conta é autenticada como uma entidade de serviço.

Exemplo 4: Conectar-se à Área de Trabalho Virtual do Windows usando uma conta principal de serviço com credenciais de certificado

# 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

`

Parâmetros

-AadTenantId

Especifica a ID do locatário do Azure AD da qual a entidade de serviço é membro.

Tipo:	String
Aliases:	TenantId
Position:	3
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ApplicationId

A ID do aplicativo da entidade de serviço para autenticar na Área de Trabalho Virtual do Windows.

Tipo:	String
Position:	2
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CertificateThumbprint

A impressão digital do certificado instalado para autenticação como entidade de serviço na Área de Trabalho Virtual do Windows.

Tipo:	String
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Credential

Especifica um objeto PSCredential. Para obter mais informações sobre o objeto PSCredential, digite Get-Help Get-Credential. O objeto PSCredential fornece o ID de usuário e a senha para credenciais de ID organizacional ou a ID do aplicativo e o segredo para credenciais da entidade de serviço.

Tipo:	PSCredential
Position:	1
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DeploymentUrl

A cadeia de caracteres URL (Universal Resource Locator) apontando para o site de gerenciamento da Área de Trabalho Virtual do Windows.

Tipo:	String
Position:	0
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ServicePrincipal

Opção indicando que essa conta é autenticada fornecendo credenciais da entidade de serviço.

Tipo:	SwitchParameter
Position:	2
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Entradas

None

Saídas

Microsoft.RDInfra.RDManagementData.RdMgmtContext