Condividi tramite

New-RdsRemoteApp

Modulo:
Microsoft.RDInfra.RDPowershell Module

Aggiunge un programma RemoteApp a un gruppo di app.

Sintassi

RA1 (impostazione predefinita). 

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

Descrizione

Aggiunge un programma RemoteApp a un gruppo di app RemoteApp. Ciò comporta la pubblicazione dell'app. Questo comando avrà esito negativo se si tenta di pubblicare un RemoteApp in un gruppo di app desktop.

Esempio

Esempio 1: Pubblicare un RemoteApp fornendo l'alias dell'app

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

Questo comando pubblica un controllo RemoteApp nel gruppo di app con tutte le proprietà associate all'alias dell'app specificato. Questo comando può essere utilizzato per le applicazioni elencate durante l'esecuzione del cmdlet Get-RdsStartMenuApp.

Esempio 2: Pubblicare un RemoteApp fornendo manualmente le informazioni

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

Questo comando pubblica un oggetto RemoteApp nel gruppo di app con le proprietà specificate, inclusi i valori predefiniti per le proprietà CommandLineSettings e ShowInWebFeed. Questo comando può essere utilizzato per qualsiasi applicazione ed è il modo preferito per pubblicare RemoteApps se l'applicazione specifica non è elencata durante l'esecuzione del cmdlet Get-RdsStartMenuApp.

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. La presenza di questo parametro determina il set di parametri AppAlias.

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 RemoteApp 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. La presenza di questo parametro determina il set di parametri FilePath.

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 di RemoteApp, che deve essere univoco nel gruppo di app. Alias: RemoteAppName.

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