Cmdleten Add-RdsAccount lägger till ett autentiserat konto som ska användas för cmdlet-begäranden för Windows Virtual Desktop. När det är klart anges kontexten automatiskt att använda "Standardklientgrupp" som klientgruppsnamn. Du kan köra cmdleten Set-RdsContext för att ändra kontexten.
Exempel
Exempel 1: Anslut till Windows Virtual Desktop via en interaktiv inloggning
Det här kommandot ansluter till ett arbets- eller skolkonto. Om du vill köra Windows Virtual Desktop-cmdlets med det här kontot måste du ange autentiseringsuppgifter för organisations-ID vid prompten. Om multifaktorautentisering är aktiverat för dina autentiseringsuppgifter måste du logga in med det interaktiva alternativet eller använda autentisering med tjänstens huvudnamn.
Exempel 2: Anslut till Windows Virtual Desktop med autentiseringsuppgifter för organisations-ID
Det första kommandot frågar efter användarautentiseringsuppgifter (användarnamn och lösenord) och lagrar dem sedan i variabeln $Credential. Det andra kommandot ansluter till Azure AD-kontot med hjälp av de autentiseringsuppgifter som lagras i $Credential. Det här kontot autentiseras med Windows Virtual Desktop med autentiseringsuppgifter för organisations-ID. Om multifaktorautentisering är aktiverat för dina autentiseringsuppgifter måste du logga in med det interaktiva alternativet eller använda autentisering med tjänstens huvudnamn.
Exempel 3: Anslut till Windows Virtual Desktop med hjälp av ett konto för tjänstens huvudnamn med autentiseringsuppgifter för lösenord
Det första kommandot hämtar autentiseringsuppgifterna för tjänstens huvudnamn (program-ID och hemlighet för tjänstens huvudnamn) och lagrar dem sedan i variabeln $Credential. Det andra kommandot ansluter till Azure AD-kontot med hjälp av autentiseringsuppgifterna för tjänstens huvudnamn som lagras i $Credential för den angivna klientorganisationen. Parametern ServicePrincipal switch anger att kontot autentiseras som tjänstens huvudnamn.
Exempel 4: Anslut till Windows Virtual Desktop med hjälp av ett konto för tjänstens huvudnamn med certifikatautentiseringsuppgifter
# 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
Parametrar
-AadTenantId
Anger det Azure AD klientorganisations-ID som tjänstens huvudnamn är medlem i.
Parameteregenskaper
Typ:
String
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Alias:
Hyresgivares-id
Parameteruppsättningar
AddAccountWithServicePrincipal
Position:
3
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
AddAccountWithThumbprint
Position:
3
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
-ApplicationId
Program-ID:t för tjänstens huvudnamn som ska autentiseras till Windows Virtual Desktop.
Parameteregenskaper
Typ:
String
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Parameteruppsättningar
AddAccountWithThumbprint
Position:
2
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
-CertificateThumbprint
Tumavtrycket för det installerade certifikatet som ska autentiseras som tjänstens huvudnamn till Windows Virtual Desktop.
Parameteregenskaper
Typ:
String
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Parameteruppsättningar
AddAccountWithThumbprint
Position:
1
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
-Credential
Anger ett PSCredential-objekt. Mer information om PSCredential-objektet finns i Get-Help Get-Credential. PSCredential-objektet tillhandahåller användar-ID och lösenord för autentiseringsuppgifter för organisations-ID eller program-ID och hemlighet för autentiseringsuppgifter för tjänstens huvudnamn.
Parameteregenskaper
Typ:
PSCredential
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Parameteruppsättningar
AddAccountWithCredential
Position:
1
Obligatorisk:
False
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
-DeploymentUrl
URL-strängen (Universal Resource Locator) som pekar på hanteringsplatsen för Windows Virtual Desktop.
Parameteregenskaper
Typ:
String
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Parameteruppsättningar
(All)
Position:
0
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
-ServicePrincipal
Växel som anger att det här kontot autentiseras genom att ange autentiseringsuppgifter för tjänstens huvudnamn.
Parameteregenskaper
Typ:
SwitchParameter
Standardvärde:
None
Stöder jokertecken:
False
DontShow:
False
Parameteruppsättningar
AddAccountWithServicePrincipal
Position:
2
Obligatorisk:
True
Värde från pipeline:
False
Värde från pipeline efter egenskapsnamn:
False
Värde från återstående argument:
False
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.