New-RdsRemoteApp
إضافة برنامج RemoteApp إلى مجموعة تطبيقات.
بناء الجملة
New-RdsRemoteApp
[-TenantName] <String>
[-HostPoolName] <String>
[-AppGroupName] <String>
[-Name] <String>
[-FilePath <String>]
[-CommandLineSetting <CommandLineSetting>]
[-Description <String>]
[-FileVirtualPath <String>]
[-FolderName <String>]
[-FriendlyName <String>]
[-IconIndex <Int32>]
[-IconPath <String>]
[-RequiredCommandLine <String>]
[-ShowInWebFeed]
[<CommonParameters>]
New-RdsRemoteApp
[-TenantName] <String>
[-HostPoolName] <String>
[-AppGroupName] <String>
[-Name] <String>
[-AppAlias <String>]
[-CommandLineSetting <CommandLineSetting>]
[-Description <String>]
[-FileVirtualPath <String>]
[-FolderName <String>]
[-FriendlyName <String>]
[-IconIndex <Int32>]
[-IconPath <String>]
[-RequiredCommandLine <String>]
[-ShowInWebFeed]
[<CommonParameters>]
الوصف
إضافة برنامج RemoteApp إلى مجموعة تطبيقات RemoteApp. يؤدي هذا إلى نشر التطبيق. سيفشل هذا الأمر إذا حاولت نشر RemoteApp إلى مجموعة تطبيقات سطح المكتب.
أمثلة
مثال 1: نشر RemoteApp عن طريق توفير الاسم المستعار للتطبيق
PS C:\> New-RdsRemoteApp -TenantName "contoso" -HostPoolname "contosoHostPool" -AppGroupName "officeApps" -Name "Excel" -AppAlias "excel"
TenantGroupName : Default Tenant Group
TenantName : contoso
HostPoolName : contosoHostPool
AppGroupName : officeApps
RemoteAppName : Excel
FilePath : C:\Program Files\Microsoft Office\root\Office16\EXCEL.EXE
AppAlias :
CommandLineSetting : DoNotAllow
Description :
FriendlyName : Excel
IconIndex : 0
IconPath : C:\Program Files\Microsoft
Office\Root\VFS\Windows\Installer\{90160000-000F-0000-1000-0000000FF1CE}\xlicons.exe
RequiredCommandLine :
ShowInWebFeed : True
ينشر هذا الأمر RemoteApp إلى مجموعة التطبيقات مع كافة الخصائص المقترنة بالاسم المستعار للتطبيق المحدد. يمكن استخدام هذا الأمر للتطبيقات المدرجة عند تشغيل Get-RdsStartMenuApp cmdlet.
مثال 2: نشر RemoteApp عن طريق توفير المعلومات يدويا
PS C:\> New-RdsRemoteApp -TenantName "contoso" -HostPoolname "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -FilePath "C:\Program Files\internet explorer\iexplore.exe" -FriendlyName "Contoso Web App" -IconPath "C:\Program Files\internet explorer\iexplore.exe"
TenantGroupName : Default Tenant Group
TenantName : contoso
HostPoolName : contosoHostPool
AppGroupName : webApps
RemoteAppName : internetExplorerContosoWebApp
FilePath : C:\Program Files\internet explorer\iexplore.exe
AppAlias :
CommandLineSetting : DoNotAllow
Description :
FriendlyName : Contoso Web App
IconIndex : 0
IconPath : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine :
ShowInWebFeed : True
ينشر هذا الأمر RemoteApp إلى مجموعة التطبيقات مع الخصائص المتوفرة، بما في ذلك القيم الافتراضية لخصائص CommandLineSettings و ShowInWebFeed. يمكن استخدام هذا الأمر لأي تطبيقات وهو الطريقة المفضلة لنشر RemoteApps إذا لم يكن التطبيق المحدد مدرجا عند تشغيل Get-RdsStartMenuApp cmdlet.
المعلمات
-AppAlias
سلسلة فريدة تم إنشاؤها بواسطة عامل مضيف RD لكل تطبيقات قائمة البدء قبل إرجاعها بواسطة عامل المضيف. يتم إرجاع AppAlias بواسطة Get-RdsStartMenuApp cmdlet ويمكن استخدامه لتحديد تطبيق للنشر. يحدد وجود هذه المعلمة مجموعة معلمات AppAlias.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-AppGroupName
اسم مجموعة التطبيقات.
النوع: | String |
Position: | 2 |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
قبول أحرف البدل: | False |
-CommandLineSetting
يحدد ما إذا كان برنامج RemoteApp يقبل وسيطات سطر الأوامر من العميل في وقت الاتصال. القيم المقبولة لهذه المعلمة هي:
- السماح: يقبل وسيطات سطر الأوامر.
- DoNotAllow: لا يقبل وسيطات سطر الأوامر.
- مطلوب: يسمح فقط كوسيطات سطر الأوامر المحددة في المعلمة RequiredCommandLine.
النوع: | CommandLineSetting |
القيم المقبولة: | Allow, DoNotAllow, Require |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Description
سلسلة مكونة من 512 حرفا تصف RemoteApp لمساعدة المسؤولين. يسمح بأي حرف.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-FilePath
يحدد مسارا للملف القابل للتنفيذ للتطبيق. قد يتضمن أي متغيرات بيئة. يجب أن يكون هذا المسار مسارا محليا صالحا على جميع مضيفي جلسة العمل في تجمع المضيف. يحدد وجود هذه المعلمة مجموعة معلمات FilePath.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-FileVirtualPath
مسار الملف إلى الملف القابل للتنفيذ للتطبيق. يجب أن يكون هذا المسار متناسقا عبر جميع مضيفي الجلسة في تجمع المضيف ويسمح بمتغيرات البيئة.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-FolderName
ملاحظه
هذه الميزة غير مدعومة بعد.
اسم المجلد حيث سيتم تجميع التطبيق في عملاء سطح المكتب البعيد.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-FriendlyName
سلسلة مكونة من 256 حرفا مخصصة للعرض للمستخدمين النهائيين. يسمح بأي حرف.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-HostPoolName
اسم تجمع المضيف.
النوع: | String |
Position: | 1 |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
قبول أحرف البدل: | False |
-IconIndex
فهرس الأيقونة من الملف القابل للتنفيذ، كما هو محدد بواسطة المعلمة IconPath.
النوع: | Int32 |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-IconPath
تحديد مسار إلى تطبيق أو ملف ico لعرضه للتطبيق. قد لا يتضمن أي متغيرات بيئة. يجب أن يكون هذا المسار مسارا محليا صالحا على جميع مضيفي جلسة العمل في تجمع المضيف.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-Name
اسم RemoteApp، والذي يجب أن يكون فريدا في مجموعة التطبيقات. الاسم المستعار: RemoteAppName.
النوع: | String |
الأسماء المستعارة: | RemoteAppName |
Position: | 3 |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
قبول أحرف البدل: | False |
-RequiredCommandLine
تحديد سلسلة تحتوي على وسيطات سطر الأوامر التي يمكن للعميل استخدامها في وقت الاتصال مع برنامج RemoteApp. إذا قمت بتحديد هذه المعلمة، يجب أن تحتوي المعلمة CommandLineSetting على قيمة Require.
النوع: | String |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-ShowInWebFeed
ملاحظه
هذه الميزة غير مدعومة بعد.
تحديد ما إذا كنت تريد إظهار برنامج RemoteApp في موجز ويب. بشكل افتراضي، يتم عرض جميع RemoteApps. ملاحظة: يسمح هذا للمسؤول بإيقاف تشغيل أحد التطبيقات مؤقتا ثم تشغيله مرة أخرى دون حذف معلومات التطبيق المخصصة وإعادة إنشائها.
النوع: | SwitchParameter |
Position: | Named |
القيمة الافتراضية: | None |
مطلوب: | False |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
قبول أحرف البدل: | False |
-TenantName
اسم المستأجر.
النوع: | String |
Position: | 0 |
القيمة الافتراضية: | None |
مطلوب: | True |
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
قبول أحرف البدل: | False |
الإدخالات
System.String
المخرجات
Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp