L’applet de commande Add-RdsAccount ajoute un compte authentifié à utiliser pour les demandes d’applet de commande Windows Virtual Desktop. Une fois l’opération terminée, le contexte est automatiquement défini pour utiliser le « Groupe de locataires par défaut » comme nom de groupe de locataires. Vous pouvez exécuter l’applet de commande Set-RdsContext pour modifier le contexte.
Exemples
Exemple 1 : Se connecter à Windows Virtual Desktop via une connexion interactive
Cette commande se connecte à un compte professionnel ou scolaire. Pour exécuter des applets de commande Windows Virtual Desktop avec ce compte, vous devez fournir des informations d’identification d’ID d’organisation à l’invite. Si l’authentification multifacteur est activée pour vos informations d’identification, vous devez vous connecter à l’aide de l’option interactive ou utiliser l’authentification du principal de service.
Exemple 2 : Se connecter à Windows Virtual Desktop à l’aide des informations d’identification de l’ID d’organisation
La première commande demande les informations d’identification de l’utilisateur (nom d’utilisateur et mot de passe), puis les stocke dans la variable $Credential. La deuxième commande se connecte au compte Azure AD à l’aide des informations d’identification stockées dans $Credential. Ce compte s’authentifie auprès de Windows Virtual Desktop à l’aide des informations d’identification de l’ID d’organisation. Si l’authentification multifacteur est activée pour vos informations d’identification, vous devez vous connecter à l’aide de l’option interactive ou utiliser l’authentification du principal de service.
Exemple 3 : Se connecter à Windows Virtual Desktop à l’aide d’un compte principal de service avec des informations d’identification de mot de passe
La première commande récupère les informations d’identification du principal de service (ID d’application et secret du principal de service), puis les stocke dans la variable $Credential. La deuxième commande se connecte au compte Azure AD à l’aide des informations d’identification du principal de service stockées dans $Credential pour le locataire spécifié. Le paramètre de commutateur ServicePrincipal indique que le compte s’authentifie en tant que principal de service.
Exemple 4 : Se connecter à Windows Virtual Desktop à l’aide d’un compte de principal de service avec des informations d’identification de certificat
# 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
Paramètres
-AadTenantId
Spécifie l’ID de locataire Azure AD dont le principal de service est membre.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Alias:
Id de locataire
Jeux de paramètres
AddAccountWithServicePrincipal
Position:
3
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
AddAccountWithThumbprint
Position:
3
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ApplicationId
ID d’application du principal de service à authentifier auprès de Windows Virtual Desktop.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
AddAccountWithThumbprint
Position:
2
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-CertificateThumbprint
Empreinte numérique du certificat installé pour s’authentifier en tant que principal de service auprès de Windows Virtual Desktop.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
AddAccountWithThumbprint
Position:
1
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-Credential
Spécifie un objet PSCredential. Pour plus d’informations sur l’objet PSCredential, tapez Get-Help Get-Credential. L’objet PSCredential fournit l’ID utilisateur et le mot de passe des informations d’identification d’ID d’organisation, ou l’ID d’application et le secret pour les informations d’identification du principal de service.
Propriétés du paramètre
Type:
PSCredential
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
AddAccountWithCredential
Position:
1
Obligatoire:
False
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-DeploymentUrl
Chaîne URL (Universal Resource Locator) pointant vers le site de gestion Windows Virtual Desktop.
Propriétés du paramètre
Type:
String
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
(All)
Position:
0
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
-ServicePrincipal
Commutateur indiquant que ce compte s’authentifie en fournissant des informations d’identification de principal de service.
Propriétés du paramètre
Type:
SwitchParameter
Valeur par défaut:
None
Prend en charge les caractères génériques:
False
DontShow:
False
Jeux de paramètres
AddAccountWithServicePrincipal
Position:
2
Obligatoire:
True
Valeur du pipeline:
False
Valeur du pipeline par nom de propriété:
False
Valeur des arguments restants:
False
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.