Add-RdsAccount

Reference

Modul:: WindowsVirtualDesktopPowershell

Přidá ověřený účet, který se použije pro žádosti o rutiny služby Windows Virtual 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

Rutina Add-RdsAccount přidá ověřený účet, který se použije pro požadavky rutin služby Windows Virtual Desktop. Po dokončení se kontext automaticky nastaví tak, aby jako název skupiny tenantů používal výchozí skupinu tenantů. Kontext můžete změnit spuštěním rutiny Set-RdsContext.

Příklady

Příklad 1: Připojení ke službě Windows Virtual Desktop prostřednictvím interaktivního přihlášení

PS C:\> Add-RdsAccount -DeploymentUrl "https://rdbroker.wvd.microsoft.com"

DeploymentUrl                       TenantGroupName       UserName
-------------                       ---------------       --------
https://rdbroker.wvd.microsoft.com  Default Tenant Group  admin@contoso.com

Tento příkaz se připojí k pracovnímu nebo školnímu účtu. Pokud chcete spouštět rutiny služby Windows Virtual Desktop s tímto účtem, musíte na příkazovém řádku zadat přihlašovací údaje id organizace. Pokud je pro vaše přihlašovací údaje povolené vícefaktorové ověřování, musíte se přihlásit pomocí interaktivní možnosti nebo použít ověřování instančního objektu.

Příklad 2: Připojení ke službě Windows Virtual Desktop pomocí přihlašovacích údajů ID organizace

`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

První příkaz vyzve k zadání přihlašovacích údajů uživatele (uživatelské jméno a heslo) a pak je uloží do proměnné $Credential. Druhý příkaz se připojí k účtu Azure AD pomocí přihlašovacích údajů uložených v $Credential. Tento účet se ověřuje ve službě Windows Virtual Desktop pomocí přihlašovacích údajů ID organizace. Pokud je pro vaše přihlašovací údaje povolené vícefaktorové ověřování, musíte se přihlásit pomocí interaktivní možnosti nebo použít ověřování instančního objektu.

Příklad 3: Připojení ke službě Windows Virtual Desktop pomocí účtu instančního objektu s přihlašovacími údaji pro heslo

`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

První příkaz získá přihlašovací údaje instančního objektu (ID aplikace a tajný klíč instančního objektu) a uloží je do proměnné $Credential. Druhý příkaz se připojí k účtu Azure AD pomocí přihlašovacích údajů instančního objektu uložených v $Credential pro zadaného tenanta. Parametr přepínače ServicePrincipal označuje, že se účet ověřuje jako instanční objekt.

Příklad 4: Připojení ke službě Windows Virtual Desktop pomocí účtu instančního objektu s přihlašovacími údaji certifikátu

# 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

Parametry

-AadTenantId

Určuje ID tenanta Azure AD, jehož členem je instanční objekt.

Type:	String
Aliases:	TenantId
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationId

ID aplikace instančního objektu, který se má ověřit ve službě Windows Virtual Desktop.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Kryptografický otisk nainstalovaného certifikátu, který se má ověřit jako instanční objekt ve službě Windows Virtual Desktop.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Určuje objekt PSCredential. Další informace o objektu PSCredential zadejte Get-Help Get-Credential. Objekt PSCredential poskytuje ID a heslo uživatele pro přihlašovací údaje ID organizace nebo ID aplikace a tajný klíč pro přihlašovací údaje instančního objektu.

Type:	PSCredential
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentUrl

Řetězec adresy URL (Universal Resource Locator) odkazující na web pro správu služby Windows Virtual Desktop.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ServicePrincipal

Přepínač označující, že se tento účet ověřuje zadáním přihlašovacích údajů instančního objektu.

Type:	SwitchParameter
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

Vstupy

None

Výstupy

Microsoft.RDInfra.RDManagementData.RdMgmtContext