New-RdsRemoteApp

모듈:

Microsoft.RDInfra.RDPowershell Module

앱 그룹에 RemoteApp 프로그램을 추가합니다.

구문

RA1 (기본값)

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

Description

RemoteApp 앱 그룹에 RemoteApp 프로그램을 추가합니다. 그러면 앱이 게시됩니다. 데스크톱 앱 그룹에 RemoteApp을 게시하려고 하면 이 명령이 실패합니다.

예제

예제 1: 앱 별칭을 제공하여 RemoteApp 게시

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

이 명령은 지정된 앱 별칭과 연결된 모든 속성을 사용하여 앱 그룹에 RemoteApp을 게시합니다. 이 명령은 Get-RdsStartMenuApp cmdlet을 실행할 때 나열되는 애플리케이션에 사용할 수 있습니다.

예제 2: 수동으로 정보를 제공하여 RemoteApp 게시

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

이 명령은 CommandLineSettings 및 ShowInWebFeed 속성에 대한 기본값을 포함하여 제공된 속성을 사용하여 앱 그룹에 RemoteApp을 게시합니다. 이 명령은 모든 응용 프로그램에 사용할 수 있으며 Get-RdsStartMenuApp cmdlet을 실행할 때 특정 응용 프로그램이 나열되지 않는 경우 RemoteApps를 게시하는 기본 방법입니다.

매개 변수

-AppAlias

호스트 에이전트에서 반환하기 전에 각 시작 메뉴 앱에 대해 RD 호스트 에이전트에서 생성된 고유한 문자열입니다. AppAlias는 Get-RdsStartMenuApp cmdlet에 의해 반환되며 게시할 앱을 식별하는 데 사용할 수 있습니다. 이 매개 변수가 있으면 AppAlias 매개 변수 집합이 결정됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

RA2

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AppGroupName

앱 그룹의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-CommandLineSetting

RemoteApp 프로그램이 연결 시 클라이언트로부터 명령줄 인수를 받아들일지 여부를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• Allow: 명령줄 인수를 허용합니다.
• DoNotAllow: 명령줄 인수를 허용하지 않습니다.
• Require: RequiredCommandLine 매개 변수에 지정된 명령줄 인수만 허용합니다.

매개 변수 속성

형식:	CommandLineSetting
Default value:	None
허용되는 값:	Allow, DoNotAllow, Require
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Description

관리자를 돕기 위해 RemoteApp을 설명하는 512자 문자열입니다. 모든 문자가 허용됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FilePath

애플리케이션의 실행 파일 경로를 지정합니다. 여기에는 모든 환경 변수가 포함될 수 있습니다. 이 경로는 호스트 풀의 모든 세션 호스트에서 유효한 로컬 경로여야 합니다. 이 매개 변수가 있으면 FilePath 매개 변수 집합이 결정됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

RA1

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FileVirtualPath

응용 프로그램의 실행 파일에 대한 파일 경로입니다. 이 경로는 호스트 풀의 모든 세션 호스트에서 일관되어야 하며 환경 변수를 허용합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FolderName

비고

이 기능은 아직 지원되지 않습니다.

Remote Desktop 클라이언트에서 응용 프로그램이 그룹화될 폴더의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FriendlyName

최종 사용자에게 표시하기 위한 256자 문자열입니다. 모든 문자가 허용됩니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HostPoolName

호스트 풀의 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-IconIndex

IconPath 매개 변수로 정의된 대로 실행 파일의 아이콘 인덱스입니다.

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IconPath

응용 프로그램에 대해 표시할 응용 프로그램 또는 ico 파일의 경로를 지정합니다. 환경 변수는 포함되지 않을 수 있습니다. 이 경로는 호스트 풀의 모든 세션 호스트에서 유효한 로컬 경로여야 합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Name

RemoteApp의 이름으로, 앱 그룹에서 고유해야 합니다. 별칭: RemoteAppName.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	원격 앱 이름

매개 변수 집합

(All)

Position:	3
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-RequiredCommandLine

클라이언트가 RemoteApp 프로그램에 연결할 때 사용할 수 있는 명령줄 인수가 포함된 문자열을 지정합니다. 이 매개 변수를 지정하는 경우 CommandLineSetting 매개 변수의 값은 Require여야 합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ShowInWebFeed

비고

이 기능은 아직 지원되지 않습니다.

웹 피드에 RemoteApp 프로그램을 표시할지 여부를 지정합니다. 기본적으로 모든 RemoteApps가 표시됩니다. 참고: 이렇게 하면 관리자가 사용자 지정 앱 정보를 삭제하고 다시 만들지 않고도 애플리케이션을 일시적으로 껐다가 다시 켤 수 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-TenantName

테넌트 이름입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	0
필수:	True
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

System.String

출력

Microsoft.RDInfra.RDManagementData.RdMgmtRemoteApp