Set-RdsRemoteApp

Modül:

Microsoft.RDInfra.RDPowershell Module

RemoteApp'in özelliklerini ayarlar.

Sözdizimi

RA1 EnterprisePublishing

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

Description

Set-RdsRemoteApp cmdlet'i, belirtilen uygulama grubuna yayımlanan bir RemoteApp'in özelliklerini ayarlar. Bu komutla, RemoteApp için görünen simgeyi, Uzak Masaüstü istemcilerinde görünen RemoteApp'ın kolay adını ve RemoteApp'in başlatılmasını (komut satırı parametreleri aracılığıyla) değiştirebilirsiniz.

Örnekler

Örnek 1: RemoteApp'in kolay adını değiştirme

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

Bu komut, RemoteApp'in kolay adını, Uzak Masaüstü istemcilerindeki son kullanıcılara görünecek olan "Contoso Web App v2" olarak değiştirir.

Örnek 2: RemoteApp'in komut satırı özelliklerini değiştirme

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

Bu komut, Internet Explorer'ın komut satırı bağımsız değişkenlerini her zaman "https://webapp.contoso.com".

Parametreler

-AppAlias

Konak aracısı tarafından döndürülmeden önce her başlat menüsü uygulaması için RD konak aracısı tarafından oluşturulan benzersiz bir dize. AppAlias, Get-RdsStartMenuApp cmdlet'i tarafından döndürülür ve yayımlamak üzere bir uygulamayı tanımlamak için kullanılabilir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

RA2

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AppGroupName

Uygulama grubunun adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	2
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CommandLineSetting

RemoteApp programının, bağlantı zamanında istemciden gelen komut satırı bağımsız değişkenlerini kabul edip etmeyeceğini belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

• İzin Ver: Komut satırı bağımsız değişkenlerini kabul eder.
• DoNotAllow: Komut satırı bağımsız değişkenlerini kabul etmez.
• Require: Yalnızca RequiredCommandLine parametresinde belirtilen komut satırı bağımsız değişkenlerine izin verir.

Parametre özellikleri

Tür:	CommandLineSetting
Default value:	None
Kabul edilen değerler:	Allow, DoNotAllow, Require
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Description

Yöneticilere yardımcı olmak için Kiracı'nın açıklandığı 512 karakterlik bir dize. Herhangi bir karaktere izin verilir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FilePath

Uygulama için yürütülebilir dosyanın yolunu belirtir. Herhangi bir ortam değişkenini içerebilir. Bu yol, konak havuzundaki tüm oturum konaklarında geçerli bir yerel yol olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

RA1

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FileVirtualPath

Uygulama için yürütülebilir dosyanın dosya yolu. Bu yol, konak havuzundaki tüm oturum konaklarında tutarlı olmalıdır ve ortam değişkenlerine izin verir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FolderName

Uyarı

Bu özellik henüz desteklenmiyor.

Uygulamanın Uzak Masaüstü istemcilerinde gruplandırılacağı klasörün adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FriendlyName

Son kullanıcılara görüntülenmek üzere tasarlanmış 256 karakterlik bir dize. Herhangi bir karaktere izin verilir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-HostPoolName

Konak havuzunun adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	1
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IconIndex

IconPath parametresi tarafından tanımlandığı şekilde, yürütülebilir dosyadaki simgenin dizini.

Parametre özellikleri

Tür:	Int32
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IconPath

Uygulama için görüntülenecek bir uygulamanın veya ico dosyasının yolunu belirtir. Herhangi bir ortam değişkeni içermeyebilir. Bu yol, konak havuzundaki tüm oturum konaklarında geçerli bir yerel yol olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

RemoteApp'in adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	RemoteAppName (RemoteAppName)

Parametre kümeleri

(All)

Position:	3
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredCommandLine

İstemcinin RemoteApp programıyla bağlantı zamanında kullanabileceği komut satırı bağımsız değişkenlerini içeren bir dize belirtir. Bu parametreyi belirtirseniz, CommandLineSetting parametresinin Require değerine sahip olması gerekir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ShowInWebFeed

Uyarı

Bu özellik henüz desteklenmiyor.

RemoteApp programının web akışında gösterilip gösterilmeyeceğini belirtir. Varsayılan olarak, tüm RemoteApps gösterilir. Not: Bu, yöneticinin bir uygulamayı geçici olarak kapatmasına ve ardından özel uygulama bilgilerini silip yeniden oluşturmadan tekrar açmasına olanak tanır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TenantName

Kiracının adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

System.String

Çıkışlar

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp