Add-RdsAccount

Başvuru

Modül:: WindowsVirtualDesktopPowershell

Windows Sanal Masaüstü cmdlet istekleri için kullanılacak kimliği doğrulanmış bir hesap ekler.

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

Add-RdsAccount cmdlet'i, Windows Sanal Masaüstü cmdlet istekleri için kullanılacak kimliği doğrulanmış bir hesap ekler. Tamamlandığında, bağlam otomatik olarak kiracı grubu adı olarak "Varsayılan Kiracı Grubu" kullanacak şekilde ayarlanır. bağlamı değiştirmek için Set-RdsContext cmdlet'ini çalıştırabilirsiniz.

Örnekler

Örnek 1: Etkileşimli oturum açma bilgileri aracılığıyla Windows Sanal Masaüstü'ne bağlanma

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

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

Bu komut bir iş veya okul hesabına bağlanır. Windows Sanal Masaüstü cmdlet'lerini bu hesapla çalıştırmak için, istemde kuruluş kimliği kimlik bilgilerini sağlamanız gerekir. Kimlik bilgileriniz için çok faktörlü kimlik doğrulaması etkinleştirildiyse etkileşimli seçeneği kullanarak oturum açmanız veya hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.

Örnek 2: Kuruluş kimliği kimlik bilgilerini kullanarak Windows Sanal Masaüstü'ne bağlanma

`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

' İlk komut kullanıcı kimlik bilgilerini (kullanıcı adı ve parola) ister ve bunları $Credential değişkeninde depolar. İkinci komut, $Credential'de depolanan kimlik bilgilerini kullanarak Azure AD hesabına bağlanır. Bu hesap, kuruluş kimliği kimlik bilgilerini kullanarak Windows Sanal Masaüstü ile kimlik doğrulaması yapar. Kimlik bilgileriniz için çok faktörlü kimlik doğrulaması etkinleştirildiyse etkileşimli seçeneği kullanarak oturum açmanız veya hizmet sorumlusu kimlik doğrulamasını kullanmanız gerekir.

Örnek 3: Parola kimlik bilgileriyle bir hizmet sorumlusu hesabı kullanarak Windows Sanal Masaüstü'ne bağlanma

`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

' İlk komut hizmet sorumlusu kimlik bilgilerini (Uygulama Kimliği ve hizmet sorumlusu gizli dizisi) alır ve bunları $Credential değişkeninde depolar. İkinci komut, belirtilen Kiracı için $Credential depolanan hizmet sorumlusu kimlik bilgilerini kullanarak Azure AD hesabına bağlanır. ServicePrincipal anahtar parametresi, hesabın hizmet sorumlusu olarak kimlik doğrulamasından geçtiğini gösterir.

Örnek 4: Sertifika kimlik bilgileriyle hizmet sorumlusu hesabı kullanarak Windows Sanal Masaüstü'ne bağlanma

# 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

Parametreler

-AadTenantId

Hizmet sorumlusunun üye olduğu Azure AD kiracı kimliğini belirtir.

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

-ApplicationId

Windows Sanal Masaüstü'nde kimlik doğrulaması için hizmet sorumlusunun uygulama kimliği.

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

-CertificateThumbprint

Windows Sanal Masaüstü'nde hizmet sorumlusu olarak kimlik doğrulaması yapmak için yüklü sertifikanın parmak izi.

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

-Credential

PSCredential nesnesini belirtir. PSCredential nesnesi hakkında daha fazla bilgi için Get-Credential Get-Help yazın. PSCredential nesnesi, kuruluş kimliği kimlik bilgileri için kullanıcı kimliği ve parola ya da hizmet sorumlusu kimlik bilgileri için uygulama kimliği ve gizli dizi sağlar.

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

-DeploymentUrl

Windows Sanal Masaüstü yönetim sitesini işaret eden Evrensel Kaynak Bulucu (URL) dizesi.

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

-ServicePrincipal

Bu hesabın hizmet sorumlusu kimlik bilgilerini sağlayarak kimlik doğrulamasını belirten anahtar.

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

Girişler

None

Çıkışlar

Microsoft.RDInfra.RDManagementData.RdMgmtContext