New-RdsRemoteApp

Modul:

Microsoft.RDInfra.RDPowershell Module

Menambahkan program RemoteApp ke grup aplikasi.

Sintaks

RA1 (Default)

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

RA2

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

Deskripsi

Menambahkan program RemoteApp ke grup aplikasi RemoteApp. Ini menghasilkan penerbitan aplikasi. Perintah ini akan gagal jika Anda mencoba menerbitkan RemoteApp ke grup aplikasi desktop.

Contoh

Contoh 1: Menerbitkan RemoteApp dengan memberikan alias aplikasi

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

Perintah ini menerbitkan RemoteApp ke grup aplikasi dengan semua properti yang terkait dengan alias aplikasi yang ditentukan. Perintah ini dapat digunakan untuk aplikasi yang tercantum saat menjalankan cmdlet Get-RdsStartMenuApp.

Contoh 2: Publikasikan RemoteApp dengan memberikan informasi secara manual

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

Perintah ini menerbitkan RemoteApp ke grup aplikasi dengan properti yang disediakan, termasuk nilai default untuk properti CommandLineSettings dan ShowInWebFeed. Perintah ini dapat digunakan untuk aplikasi apa pun dan merupakan cara yang lebih disukai untuk menerbitkan RemoteApps jika aplikasi tertentu tidak tercantum saat menjalankan cmdlet Get-RdsStartMenuApp.

Parameter

-AppAlias

String unik yang dihasilkan oleh agen host RD untuk setiap aplikasi menu mulai sebelum dikembalikan oleh agen host. AppAlias dikembalikan oleh cmdlet Get-RdsStartMenuApp dan dapat digunakan untuk mengidentifikasi aplikasi untuk dipublikasikan. Kehadiran parameter ini menentukan set parameter AppAlias.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

RA2

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-AppGroupName

Nama grup aplikasi.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	2
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-CommandLineSetting

Menentukan apakah program RemoteApp menerima argumen baris perintah dari klien pada waktu koneksi. Nilai yang dapat diterima untuk parameter ini adalah:

• Izinkan: Menerima argumen baris perintah.
• DoNotAllow: Tidak menerima argumen baris perintah.
• Memerlukan: Hanya mengizinkan argumen baris perintah yang ditentukan dalam parameter RequiredCommandLine.

Properti parameter

Jenis:	CommandLineSetting
Nilai default:	None
Nilai yang diterima:	Allow, DoNotAllow, Require
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Description

String 512 karakter yang menjelaskan RemoteApp untuk membantu administrator. Karakter apa pun diperbolehkan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FilePath

Menentukan jalur untuk file yang dapat dieksekusi untuk aplikasi. Ini mungkin termasuk variabel lingkungan apa pun. Jalur ini harus berupa jalur lokal yang valid pada semua host sesi di kumpulan host. Kehadiran parameter ini menentukan kumpulan parameter FilePath.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

RA1

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FileVirtualPath

Jalur file ke file yang dapat dieksekusi untuk aplikasi. Jalur ini harus konsisten di semua host sesi di kumpulan host dan mengizinkan variabel lingkungan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FolderName

Nota

Fitur ini belum didukung.

Nama folder tempat aplikasi akan dikelompokkan di klien Desktop Jarak Jauh.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FriendlyName

String 256 karakter yang ditujukan untuk ditampilkan kepada pengguna akhir. Karakter apa pun diperbolehkan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-HostPoolName

Nama kumpulan host.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	1
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-IconIndex

Indeks ikon dari file yang dapat dieksekusi, seperti yang ditentukan oleh parameter IconPath.

Properti parameter

Jenis:	Int32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-IconPath

Menentukan jalur ke aplikasi atau file ico untuk ditampilkan untuk aplikasi. Ini mungkin tidak menyertakan variabel lingkungan apa pun. Jalur ini harus berupa jalur lokal yang valid pada semua host sesi di kumpulan host.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

Nama RemoteApp, yang harus unik di grup aplikasi. Alias: RemoteAppName.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Nama Aplikasi Jarak Jauh

Set parameter

(All)

Position:	3
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-RequiredCommandLine

Menentukan string yang berisi argumen baris perintah yang dapat digunakan klien pada waktu koneksi dengan program RemoteApp. Jika Anda menentukan parameter ini, parameter CommandLineSetting harus memiliki nilai Require.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ShowInWebFeed

Nota

Fitur ini belum didukung.

Menentukan apakah akan menampilkan program RemoteApp di umpan web. Secara default, semua RemoteApps ditampilkan. Catatan: Hal ini memungkinkan admin untuk menonaktifkan aplikasi untuk sementara dan kemudian mengaktifkannya kembali tanpa menghapus dan membuat ulang informasi aplikasi kustom.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-TenantName

Nama penyewa.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp