Add-RdsAccount

إضافة حساب مصادق عليه لاستخدامه لطلبات Cmdlet لسطح المكتب الظاهري ل Windows.

بناء الجملة

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>]

الوصف

يضيف Add-RdsAccount cmdlet حسابا مصادقا لاستخدامه لطلبات Cmdlet لسطح المكتب الظاهري ل Windows. عند الانتهاء، يتم تعيين السياق تلقائيا لاستخدام "مجموعة المستأجرين الافتراضية" كاسم مجموعة المستأجرين. يمكنك تشغيل Set-RdsContext cmdlet لتغيير السياق.

أمثلة

مثال 1: الاتصال بسطح المكتب الظاهري ل Windows من خلال تسجيل دخول تفاعلي

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

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

يتصل هذا الأمر بحساب العمل أو المؤسسة التعليمية. لتشغيل أوامر cmdlets لسطح المكتب الظاهري ل Windows باستخدام هذا الحساب، يجب توفير بيانات اعتماد معرف المؤسسة عند المطالبة. إذا تم تمكين المصادقة متعددة العوامل لبيانات الاعتماد الخاصة بك، يجب تسجيل الدخول باستخدام الخيار التفاعلي أو استخدام المصادقة الأساسية للخدمة.

مثال 2: الاتصال بسطح المكتب الظاهري ل Windows باستخدام بيانات اعتماد المعرف التنظيمي

`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

' سيطالب الأمر الأول ببيانات اعتماد المستخدم (اسم المستخدم وكلمة المرور)، ثم يخزنها في متغير $Credential. يتصل الأمر الثاني بحساب Azure AD باستخدام بيانات الاعتماد المخزنة في $Credential. يصادق هذا الحساب مع Windows Virtual Desktop باستخدام بيانات اعتماد معرف المؤسسة. إذا تم تمكين المصادقة متعددة العوامل لبيانات الاعتماد الخاصة بك، يجب تسجيل الدخول باستخدام الخيار التفاعلي أو استخدام المصادقة الأساسية للخدمة.

مثال 3: الاتصال بسطح المكتب الظاهري ل Windows باستخدام حساب كيان الخدمة مع بيانات اعتماد كلمة المرور

`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

' يحصل الأمر الأول على بيانات اعتماد كيان الخدمة (معرف التطبيق وسر كيان الخدمة)، ثم يخزنها في متغير $Credential. يتصل الأمر الثاني بحساب Azure AD باستخدام بيانات اعتماد كيان الخدمة المخزنة في $Credential للمستأجر المحدد. تشير معلمة تبديل ServicePrincipal إلى أن الحساب يصادق ككيان خدمة.

مثال 4: الاتصال بسطح المكتب الظاهري ل Windows باستخدام حساب كيان الخدمة مع بيانات اعتماد الشهادة

# 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

`

المعلمات

-AadTenantId

يحدد معرف مستأجر Azure AD الذي يكون كيان الخدمة عضوا منه.

النوع:String
الأسماء المستعارة:TenantId
Position:3
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ApplicationId

معرف التطبيق الخاص بكيان الخدمة للمصادقة على Windows Virtual Desktop.

النوع:String
Position:2
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-CertificateThumbprint

بصمة الإبهام للشهادة المثبتة للمصادقة ككيان خدمة لسطح المكتب الظاهري ل Windows.

النوع:String
Position:1
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-Credential

تحديد كائن PSCredential. لمزيد من المعلومات حول العنصر PSCredential، اكتب Get-Help Get-Credential. يوفر الكائن PSCredential معرف المستخدم وكلمة المرور لبيانات اعتماد معرف المؤسسة أو معرف التطبيق والبيانات السرية لبيانات اعتماد كيان الخدمة.

النوع:PSCredential
Position:1
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-DeploymentUrl

سلسلة Universal Resource Locator (URL) التي تشير إلى موقع إدارة سطح المكتب الظاهري ل Windows.

النوع:String
Position:0
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-ServicePrincipal

التبديل الذي يشير إلى أن هذا الحساب يصادق عن طريق توفير بيانات اعتماد كيان الخدمة.

النوع:SwitchParameter
Position:2
القيمة الافتراضية:None
مطلوب:True
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

الإدخالات

None

المخرجات

Microsoft.RDInfra.RDManagementData.RdMgmtContext