Condividi tramite

Set-RdsRemoteApp

Modulo:
Microsoft.RDInfra.RDPowershell Module

Imposta le proprietà di un controllo RemoteApp.

Sintassi

RA1 (impostazione predefinita). 

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

Descrizione

Il cmdlet Set-RdsRemoteApp imposta le proprietà per un oggetto RemoteApp pubblicato nel gruppo di app specificato. Con questo comando è possibile modificare l'icona visualizzata per RemoteApp, il nome descrittivo di RemoteApp visualizzato nei client Desktop remoto e l'esecuzione dell'avvio di RemoteApp (tramite i parametri della riga di comando).

Esempio

Esempio 1: Modificare il nome descrittivo di 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

Questo comando modifica il nome descrittivo di RemoteApp in "Contoso Web App v2" che verrà visualizzato agli utenti finali nei client Desktop remoto.

Esempio 2: Modificare le proprietà della riga di comando di 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

Questo comando modifica gli argomenti della riga di comando di Internet Explorer in modo che avvii sempre "https://webapp.contoso.com".

Parametri

-AppAlias

Stringa univoca generata dall'agente host Desktop remoto per ogni app del menu Start prima che venga restituita dall'agente host. AppAlias viene restituito dal cmdlet Get-RdsStartMenuApp e può essere usato per identificare un'app per la pubblicazione.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

RA2
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AppGroupName

Nome del gruppo di app.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-CommandLineSetting

Specifica se il programma RemoteApp accetta gli argomenti della riga di comando dal client in fase di connessione. I valori accettabili per questo parametro sono:

  • Consenti: accetta gli argomenti della riga di comando.
  • DoNotAllow: non accetta argomenti della riga di comando.
  • Require: consente solo gli argomenti della riga di comando specificati nel parametro RequiredCommandLine.

Proprietà dei parametri

Tipo:CommandLineSetting
Valore predefinito:None
Valori accettati:Allow, DoNotAllow, Require
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Description

Stringa di 512 caratteri che descrive il tenant per aiutare gli amministratori. Qualsiasi carattere è consentito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FilePath

Specifica un percorso per il file eseguibile per l'applicazione. Può includere qualsiasi variabile di ambiente. Questo percorso deve essere un percorso locale valido in tutti gli host di sessione nel pool di host.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

RA1
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FileVirtualPath

Percorso del file eseguibile per l'applicazione. Questo percorso deve essere coerente in tutti gli host di sessione nel pool di host e consente le variabili di ambiente.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FolderName

Annotazioni

Questa funzionalità non è ancora supportata.

Il nome della cartella in cui l'applicazione verrà raggruppata nei client Desktop remoto.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FriendlyName

Stringa di 256 caratteri destinata alla visualizzazione agli utenti finali. Qualsiasi carattere è consentito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-HostPoolName

Nome del pool di host.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-IconIndex

Indice dell'icona del file eseguibile, come definito dal parametro IconPath.

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IconPath

Specifica il percorso di un'applicazione o di un file ico da visualizzare per l'applicazione. Potrebbe non includere variabili di ambiente. Questo percorso deve essere un percorso locale valido in tutti gli host di sessione nel pool di host.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome dell'app remota.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:NomeApp Remoto

Set di parametri

(All)
Posizione:3
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-RequiredCommandLine

Specifica una stringa che contiene argomenti della riga di comando che il client può utilizzare in fase di connessione con il programma RemoteApp. Se si specifica questo parametro, il valore del parametro CommandLineSetting deve essere Require.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ShowInWebFeed

Annotazioni

Questa funzionalità non è ancora supportata.

Specifica se visualizzare il programma RemoteApp nel feed Web. Per impostazione predefinita, vengono visualizzate tutte le RemoteApp. Nota: Ciò consente all'amministratore di disattivare temporaneamente un'applicazione e quindi di riattivarla senza eliminare e ricreare le informazioni dell'app personalizzata.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TenantName

Nome del tenant.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

System.String

Output

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp