Set-RdsRemoteApp

Module:

Microsoft.RDInfra.RDPowershell Module

Définit les propriétés d’une RemoteApp.

Syntaxe

RA1 (Par défaut)

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

L’applet de commande Set-RdsRemoteApp définit les propriétés d’une application distante publiée dans le groupe d’applications spécifié. À l’aide de cette commande, vous pouvez modifier l’icône qui s’affiche pour RemoteApp, le nom convivial de RemoteApp qui apparaît dans les clients Bureau à distance et l’exécution au démarrage de RemoteApp (via les paramètres de ligne de commande).

Exemples

Exemple 1 : Modifier le nom convivial de la 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

Cette commande remplace le nom convivial de RemoteApp par « Contoso Web App v2 », qui s’affiche pour les utilisateurs finaux dans les clients Bureau à distance.

Exemple 2 : Modifier les propriétés de ligne de commande de 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

Cette commande modifie les arguments de la ligne de commande d’Internet Explorer pour qu’ils lancent toujours "https://webapp.contoso.com" ;.

Paramètres

-AppAlias

Chaîne unique générée par l’agent hôte Bureau à distance pour chaque application du menu Démarrer avant d’être renvoyée par l’agent hôte. AppAlias est renvoyé par l’applet de commande Get-RdsStartMenuApp et peut être utilisé pour identifier une application à publier.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

RA2

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-AppGroupName

Nom du groupe d’applications.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	2
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-CommandLineSetting

Spécifie si le programme RemoteApp accepte les arguments de ligne de commande du client au moment de la connexion. Les valeurs acceptables pour ce paramètre sont les suivantes :

• Allow : accepte les arguments de ligne de commande.
• DoNotAllow : n’accepte pas les arguments de ligne de commande.
• Require : autorise uniquement les arguments de ligne de commande spécifiés dans le paramètre RequiredCommandLine.

Propriétés du paramètre

Type:	CommandLineSetting
Valeur par défaut:	None
Valeurs acceptées:	Allow, DoNotAllow, Require
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Description

Chaîne de caractères 512 qui décrit le locataire pour aider les administrateurs. Tout caractère est autorisé.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FilePath

Spécifie un chemin d’accès pour le fichier exécutable de l’application. Il peut inclure n’importe quelle variable d’environnement. Ce chemin d’accès doit être un chemin d’accès local valide sur tous les hôtes de session du pool d’hôtes.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

RA1

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FileVirtualPath

Chemin d’accès au fichier exécutable de l’application. Ce chemin d’accès doit être cohérent entre tous les hôtes de session du pool d’hôtes et autorise les variables d’environnement.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FolderName

Remarque

Cette fonctionnalité n’est pas encore prise en charge.

Nom du dossier dans lequel l’application sera regroupée dans les clients Bureau à distance.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-FriendlyName

Chaîne de 256 caractères destinée aux utilisateurs finaux. Tout caractère est autorisé.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-HostPoolName

Nom du pool d’hôtes.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	1
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-IconIndex

Index de l’icône du fichier exécutable, tel que défini par le paramètre IconPath.

Propriétés du paramètre

Type:	Int32
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-IconPath

Spécifie un chemin d’accès à une application ou à un fichier ico à afficher pour l’application. Il peut ne pas inclure de variables d’environnement. Ce chemin d’accès doit être un chemin d’accès local valide sur tous les hôtes de session du pool d’hôtes.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-Name

Nom de la RemoteApp.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False
Alias:	RemoteAppName

Jeux de paramètres

(All)

Position:	3
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

-RequiredCommandLine

Spécifie une chaîne qui contient des arguments de ligne de commande que le client peut utiliser au moment de la connexion avec le programme RemoteApp. Si vous spécifiez ce paramètre, la valeur Require doit être attribuée au paramètre CommandLineSetting.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-ShowInWebFeed

Remarque

Cette fonctionnalité n’est pas encore prise en charge.

Spécifie s’il faut afficher le programme RemoteApp dans le flux Web. Par défaut, toutes les RemoteApps sont affichées. Remarque : Cela permet à l’administrateur de désactiver temporairement une application, puis de la réactiver sans supprimer et recréer les informations de l’application personnalisée.

Propriétés du paramètre

Type:	SwitchParameter
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	Named
Obligatoire:	False
Valeur du pipeline:	False
Valeur du pipeline par nom de propriété:	False
Valeur des arguments restants:	False

-TenantName

Nom du client.

Propriétés du paramètre

Type:	String
Valeur par défaut:	None
Prend en charge les caractères génériques:	False
DontShow:	False

Jeux de paramètres

(All)

Position:	0
Obligatoire:	True
Valeur du pipeline:	True
Valeur du pipeline par nom de propriété:	True
Valeur des arguments restants:	False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

System.String

Sorties

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp