Add-RdsAccount
Adiciona uma conta autenticada para usar para pedidos de cmdlet virtual do Windows Desktop.
Syntax
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 Add-RdsAccount cmdlet adiciona uma conta autenticada para usar para pedidos de cmdlet virtual do Windows Desktop. Após a conclusão, o contexto é automaticamente definido para usar o "Grupo inquilino padrão" como nome do grupo de inquilinos. Pode executar o Set-RdsContext cmdlet para alterar o contexto.
Exemplos
Exemplo 1: Conecte-se ao Windows Virtual Desktop através 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 de trabalho ou escola. Para executar os cmdlets virtual do Windows desktop com esta conta, tem de fornecer credenciais de ID organizacional ao pedido. Se a autenticação multi-factor estiver ativada para as suas credenciais, deve iniciar sessão utilizando a opção interativa ou utilizar a autenticação principal do serviço.
Exemplo 2: Conecte-se ao Windows Virtual Desktop usando credenciais de ID organizacionais
`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 utilizador (nome de utilizador e palavra-passe) e, em seguida, armazena-as na variável $Credential. O segundo comando liga-se à conta Azure AD utilizando as credenciais armazenadas em $Credential. Esta conta autentica-se com o Windows Virtual Desktop utilizando credenciais de ID organizacionais. Se a autenticação multi-factor estiver ativada para as suas credenciais, deve iniciar sessão utilizando a opção interativa ou utilizar a autenticação principal do serviço.
Exemplo 3: Conecte-se ao Windows Virtual Desktop utilizando 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 principais do serviço (ID de aplicação e segredo principal do serviço), e depois armazena-as na variável $Credential. O segundo comando liga-se à conta Azure AD utilizando as credenciais principais de serviço armazenadas em $Credential para o Inquilino especificado. O parâmetro do comutador ServicePrincipal indica que a conta autentica como principal de serviço.
Exemplo 4: Conecte-se ao Windows Virtual Desktop utilizando 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 identificação do inquilino Azure AD a partir do qual o diretor de serviço é membro.
Type: | String |
Aliases: | TenantId |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApplicationId
O ID da aplicação do principal do serviço para autenticar para o Windows Virtual Desktop.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
A impressão digital para o certificado instalado para autenticar como principal de serviço para o Windows Virtual Desktop.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica um objeto PSCredential. Para mais informações sobre o objeto PSCredential, escreva Get-Help Get-Credential. O objeto PSCredential fornece o ID do utilizador e a palavra-passe para credenciais de ID organizacional, ou o ID de aplicação e segredo para credenciais principais do serviço.
Type: | PSCredential |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentUrl
A cadeia de localização de recursos universal (URL) aponta para o site de gestão virtual do Windows Desktop.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServicePrincipal
O comutador indica que esta conta autentica fornecendo credenciais principais de serviço.
Type: | SwitchParameter |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
Microsoft.RDInfra.RDManagementData.RdMgmtContext