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