Set-RdsRemoteApp

參考

模組:: WindowsVirtualDesktopPowershell

設定 RemoteApp 的屬性。

語法

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

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

Description

Set-RdsRemoteApp Cmdlet 會設定發佈至指定應用程式群組的 RemoteApp 屬性。使用此命令，您可以變更 RemoteApp 所顯示的圖示、遠端桌面用戶端中顯示的 RemoteApp 易記名稱，以及透過命令列參數) 啟動執行 RemoteApp (。

範例

範例 1：變更 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

此命令會將 RemoteApp 的易記名稱變更為「Contoso Web App v2」，這會對遠端桌面用戶端中的使用者顯示。

範例 2：變更 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

此命令會將 Internet Explorer 的命令列引數變更為一律啟動「 https://webapp.contoso.com" ;。

參數

-AppAlias

在主機代理程式傳回之前，每個開始功能表應用程式的 RD 主機代理程式所產生的唯一字串。 AppAlias 是由 Get-RdsStartMenuApp Cmdlet 傳回，可用來識別要發佈的應用程式。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AppGroupName

應用程式群組的名稱。

類型:	String
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-CommandLineSetting

指定 RemoteApp 程式是否在連線時接受來自用戶端的命令列引數。此參數可接受的值為：

允許：接受命令列引數。
DoNotAllow：不接受命令列引數。
Require：只允許 RequiredCommandLine 參數中指定的命令列引數。

類型:	CommandLineSetting
接受的值:	Allow, DoNotAllow, Require
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

描述租使用者以協助系統管理員的 512 個字元字串。允許任何字元。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-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 的名稱。

類型:	String
別名:	RemoteAppName
Position:	3
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-RequiredCommandLine

指定字串，其中包含用戶端可以在連線時間與 RemoteApp 程式使用的命令列引數。如果您指定此參數，CommandLineSetting 參數的值必須為 Require。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ShowInWebFeed

注意