Set-RdsRemoteApp

Modul:

Microsoft.RDInfra.RDPowershell Module

Mengatur properti untuk RemoteApp.

Sintaks

RA1 (Default)

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

Set-RdsRemoteApp
    [-TenantName] <String>
    [-HostPoolName] <String>
    [-AppGroupName] <String>
    [-Name] <String>
    [-CommandLineSetting <CommandLineSetting>]
    [-Description <String>]
    [-FileVirtualPath <String>]
    [-FolderName <String>]
    [-FriendlyName <String>]
    [-IconIndex <Int32>]
    [-IconPath <String>]
    [-RequiredCommandLine <String>]
    [-ShowInWebFeed]
    [-AppAlias <String>]
    [<CommonParameters>]

Deskripsi

Cmdlet Set-RdsRemoteApp mengatur properti untuk RemoteApp yang diterbitkan ke grup aplikasi yang ditentukan. Dengan perintah ini, Anda dapat mengubah ikon yang muncul untuk RemoteApp, nama ramah RemoteApp yang muncul di klien Remote Desktop, dan eksekusi start-up RemoteApp (melalui parameter baris perintah).

Contoh

Contoh 1: Ubah nama ramah RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -FriendlyName "Contoso Web App v2"

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 v2
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine :
ShowInWebFeed       : True

Perintah ini mengubah nama ramah RemoteApp menjadi "Contoso Web App v2" yang akan muncul kepada pengguna akhir di klien Desktop Jarak Jauh.

Contoh 2: Mengubah properti baris perintah RemoteApp

PS C:\> Set-RdsRemoteApp -TenantName "contoso" -HostPoolName "contosoHostPool" -AppGroupName "webApps" -Name "internetExplorerContosoWebApp" -CommandLineSetting Require -RequiredCommandLine "https://webapp.contoso.com"

TenantGroupName     : Default Tenant Group
TenantName          : contoso
HostPoolName        : contosoHostPool
AppGroupName        : webApps
RemoteAppName       : internetExplorerContosoWebApp
FilePath            : C:\Program Files\internet explorer\iexplore.exe
AppAlias            :
CommandLineSetting  : Require
Description         :
FriendlyName        : Contoso Web App v2
IconIndex           : 0
IconPath            : C:\Program Files\internet explorer\iexplore.exe
RequiredCommandLine : https://webapp.contoso.com
ShowInWebFeed       : True

Perintah ini mengubah argumen baris perintah Internet Explorer untuk selalu meluncurkan "https://webapp.contoso.com".

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.

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 karakter 512 yang menjelaskan Penyewa 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.

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.

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