El cmdlet Add-RdsAccount agrega una cuenta autenticada que se usará para las solicitudes de cmdlet de Windows Virtual Desktop. Al finalizar, el contexto se establece automáticamente para usar el "Grupo de inquilinos predeterminado" como nombre del grupo de inquilinos. Puede ejecutar el cmdlet Set-RdsContext para cambiar el contexto.
Ejemplos
Ejemplo 1: Conectarse a Windows Virtual Desktop a través de un inicio de sesión interactivo
Este comando se conecta a una cuenta profesional o educativa. Para ejecutar cmdlets de Windows Virtual Desktop con esta cuenta, debe proporcionar credenciales de identificador de organización cuando se le solicite. Si la autenticación multifactor está habilitada para las credenciales, debe iniciar sesión con la opción interactiva o usar la autenticación de entidad de servicio.
Ejemplo 2: Conectarse a Windows Virtual Desktop mediante credenciales de identificador de organización
El primer comando solicitará las credenciales de usuario (nombre de usuario y contraseña) y, a continuación, las almacenará en la variable $Credential. El segundo comando se conecta a la cuenta de Azure AD mediante las credenciales almacenadas en $Credential. Esta cuenta se autentica con Windows Virtual Desktop mediante credenciales de identificador de organización. Si la autenticación multifactor está habilitada para las credenciales, debe iniciar sesión con la opción interactiva o usar la autenticación de entidad de servicio.
Ejemplo 3: Conectarse a Windows Virtual Desktop mediante una cuenta de entidad de servicio con credenciales de contraseña
El primer comando obtiene las credenciales de la entidad de servicio (identificador de aplicación y secreto de entidad de servicio) y, a continuación, las almacena en la variable $Credential. El segundo comando se conecta a la cuenta de Azure AD mediante las credenciales de entidad de servicio almacenadas en $Credential para el inquilino especificado. El parámetro del modificador ServicePrincipal indica que la cuenta se autentica como una entidad de servicio.
Ejemplo 4: Conectarse a Windows Virtual Desktop mediante una cuenta de entidad de servicio con credenciales 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 = "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
Parámetros
-AadTenantId
Especifica el identificador de inquilino de Azure AD del que es miembro la entidad de servicio.
Propiedades del parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Alias:
Id del inquilino
Conjuntos de parámetros
AddAccountWithServicePrincipal
Posición:
3
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
AddAccountWithThumbprint
Posición:
3
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-ApplicationId
Identificador de aplicación de la entidad de servicio que se va a autenticar en Windows Virtual Desktop.
Propiedades del parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
AddAccountWithThumbprint
Posición:
2
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-CertificateThumbprint
Huella digital del certificado instalado para autenticarse como entidad de servicio en Windows Virtual Desktop.
Propiedades del parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
AddAccountWithThumbprint
Posición:
1
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-Credential
Especifica un objeto PSCredential. Para obtener más información sobre el objeto PSCredential, escriba Get-Help Get-Credential. El objeto PSCredential proporciona el identificador de usuario y la contraseña para las credenciales de identificador de la organización, o el identificador de aplicación y el secreto para las credenciales de la entidad de servicio.
Propiedades del parámetro
Tipo:
PSCredential
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
AddAccountWithCredential
Posición:
1
Mandatory:
False
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-DeploymentUrl
La cadena del localizador universal de recursos (URL) que apunta al sitio de administración de Windows Virtual Desktop.
Propiedades del parámetro
Tipo:
String
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
(All)
Posición:
0
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
-ServicePrincipal
Modificador que indica que esta cuenta se autentica proporcionando credenciales de entidad de servicio.
Propiedades del parámetro
Tipo:
SwitchParameter
Valor predeterminado:
None
Admite caracteres comodín:
False
DontShow:
False
Conjuntos de parámetros
AddAccountWithServicePrincipal
Posición:
2
Mandatory:
True
Valor de la canalización:
False
Valor de la canalización por nombre de propiedad:
False
Valor de los argumentos restantes:
False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.