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