Il cmdlet Add-RdsAccount aggiunge un account autenticato da usare per le richieste del cmdlet di Desktop virtuale Windows. Al termine, il contesto viene impostato automaticamente per l'utilizzo del "Gruppo tenant predefinito" come nome del gruppo tenant. È possibile eseguire il cmdlet Set-RdsContext per modificare il contesto.
Esempio
Esempio 1: Connettersi a Desktop virtuale Windows tramite un account di accesso interattivo
Questo comando si connette a un account aziendale o dell'istituto di istruzione. Per eseguire i cmdlet di Desktop virtuale Windows con questo account, è necessario fornire le credenziali dell'ID organizzazione al prompt. Se per le credenziali è abilitata l'autenticazione a più fattori, è necessario accedere usando l'opzione interattiva o usare l'autenticazione dell'entità servizio.
Esempio 2: Connettersi a Desktop virtuale Windows usando le credenziali dell'ID organizzazione
Il primo comando richiederà le credenziali dell'utente (nome utente e password) e quindi le memorizzerà nella variabile $Credential. Il secondo comando si connette all'account Azure AD usando le credenziali archiviate in $Credential. Questo account esegue l'autenticazione con Desktop virtuale Windows utilizzando le credenziali dell'ID organizzazione. Se per le credenziali è abilitata l'autenticazione a più fattori, è necessario accedere usando l'opzione interattiva o usare l'autenticazione dell'entità servizio.
Esempio 3: Connettersi a Desktop virtuale Windows usando un account dell'entità servizio con credenziali password
Il primo comando ottiene le credenziali dell'entità servizio (ID applicazione e segreto dell'entità servizio) e quindi le archivia nella variabile $Credential. Il secondo comando si connette all'account Azure AD usando le credenziali dell'entità servizio archiviate in $Credential per il tenant specificato. Il parametro switch ServicePrincipal indica che l'account viene autenticato come entità servizio.
Esempio 4: Connettersi a Desktop virtuale Windows usando un account dell'entità servizio con credenziali del certificato
# 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
Parametri
-AadTenantId
Specifica l'ID tenant di Azure AD di cui l'entità servizio è membro.
Proprietà dei parametri
Tipo:
String
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Alias:
ID dell'inquilino
Set di parametri
AddAccountWithServicePrincipal
Posizione:
3
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
AddAccountWithThumbprint
Posizione:
3
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-ApplicationId
ID applicazione dell'entità servizio per l'autenticazione in Desktop virtuale Windows.
Proprietà dei parametri
Tipo:
String
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
AddAccountWithThumbprint
Posizione:
2
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-CertificateThumbprint
Identificazione personale per il certificato installato per l'autenticazione come entità servizio in Desktop virtuale Windows.
Proprietà dei parametri
Tipo:
String
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
AddAccountWithThumbprint
Posizione:
1
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-Credential
Specifica un oggetto PSCredential. Per altre informazioni sull'oggetto PSCredential, digitare Get-Help Get-Credential. L'oggetto PSCredential fornisce l'ID utente e la password per le credenziali dell'ID organizzazione oppure l'ID applicazione e il segreto per le credenziali dell'entità servizio.
Proprietà dei parametri
Tipo:
PSCredential
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
AddAccountWithCredential
Posizione:
1
Obbligatorio:
False
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-DeploymentUrl
Stringa URL (Universal Resource Locator) che punta al sito di gestione di Desktop virtuale Windows.
Proprietà dei parametri
Tipo:
String
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
(All)
Posizione:
0
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
-ServicePrincipal
Interruttore che indica che l'account esegue l'autenticazione fornendo le credenziali dell'entità servizio.
Proprietà dei parametri
Tipo:
SwitchParameter
Valore predefinito:
None
Supporta i caratteri jolly:
False
DontShow:
False
Set di parametri
AddAccountWithServicePrincipal
Posizione:
2
Obbligatorio:
True
Valore dalla pipeline:
False
Valore dalla pipeline in base al nome della proprietà:
False
Valore dagli argomenti rimanenti:
False
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.