New-CMProgram

모듈:

ConfigurationManager

패키지에 대한 새 프로그램을 만듭니다.

구문

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageId <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

이 cmdlet을 사용하여 패키지에 대한 프로그램을 만듭니다. 프로그램은 Configuration Manager 패키지와 연결된 명령입니다. 클라이언트가 클라이언트 패키지를 받을 때 발생하는 작업을 식별합니다. 여러 프로그램을 동일한 패키지와 연결할 수 있습니다. 자세한 내용은 Configuration Manager의 패키지 및 프로그램을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 프로그램 만들기

이 예제 에서는 먼저 cmdlet 매개 변수를 매개 변수 변수에 배치합니다. 매개 변수를 스플랫할 필요는 없습니다. 이렇게 긴 명령줄에 대한 매개 변수를 더 쉽게 읽을 수 있습니다.

이 명령은 기본 Windows용 사용자 상태 마이그레이션 도구 패키지에 x64 검사라는 프로그램을 만듭니다.

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

매개 변수

-AddSupportedOperatingSystemPlatform

프로그램에 추가할 하나 이상의 지원되는 OS 플랫폼을 지정합니다. 이 개체를 얻으려면 Get-CMSupportedPlatform cmdlet을 사용합니다.

형식:	IResultObject[]
별칭:	AddSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CommandLine

프로그램의 명령줄을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CommandLineFolder

실행 프로그램이 포함된 폴더를 지정합니다. 이 폴더는 클라이언트의 절대 경로이거나 패키지가 포함된 배포 폴더에 상대적인 경로일 수 있습니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Comment

설명과 같이 프로그램에 대한 선택적 텍스트를 지정합니다. 클라이언트 컴퓨터에서 이 텍스트는 소프트웨어 센터의 프로그램과 함께 표시됩니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DeviceProgramName

디바이스 프로그램 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DiskSpaceRequirement

소프트웨어 프로그램이 컴퓨터에서 실행하는 데 필요한 디스크 공간의 양을 지정합니다. 값은 0보다 크거나 같아야 합니다. 값을 지정하는 경우 DiskSpaceUnit 매개 변수를 사용하여 값의 단위를 지정합니다.

형식:	String
별칭:	DiskSpaceReq
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DiskSpaceUnit

DiskSpaceRequirement 매개 변수에 허용되는 단위를 지정합니다.

형식:	DiskSpaceUnitType
허용되는 값:	KB, MB, GB
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DownloadProgramType

프로그램을 실행할 시기를 지정합니다.

형식:	DownloadProgramType
허용되는 값:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DriveLetter

DriveMode 매개 변수를 사용하는 경우 위치에 대한 드라이브 문자를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DriveMode

프로그램에 DriveLetter 매개 변수에 지정된 특정 드라이브 문자가 필요한지 여부를 나타냅니다.

• RunWithUnc: UNC 경로에서 프로그램을 실행합니다. 이 값은 기본값입니다. 버전 2010부터 이 값의 이름이 에서 바뀌었습니다 RenameWithUnc.

• RequiresDriveLetter: 프로그램에서 사용 가능한 드라이브 문자를 사용합니다.

• RequiresSpecificDriveLetter: 드라이브가 아직 사용되지 않는 경우에만 프로그램이 실행됩니다.

형식:	DriveModeType
허용되는 값:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Duration

프로그램이 실행되도록 예상하는 최대 시간을 지정합니다. 기본값은 120분입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PackageId

이 프로그램의 패키지 ID를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PackageName

이 프로그램의 패키지 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProgramRunType

프로그램을 실행하는 데 필요한 로그온 조건을 지정합니다.

기본 설정은 입니다 OnlyWhenUserIsLoggedOn.

형식:	ProgramRunType
허용되는 값:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Reconnect

사용자가 Windows에 로그인할 때 클라이언트 컴퓨터가 배포 지점에 다시 연결되는지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Requirement

표준 또는 디바이스 프로그램에 대한 추가 요구 사항을 지정합니다.

형식:	String
별칭:	Requirements
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RunMode

프로그램이 클라이언트 컴퓨터에서 실행하는 데 필요한 자격 증명을 지정합니다.

형식:	RunModeType
허용되는 값:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RunType

프로그램이 클라이언트 컴퓨터에서 실행되는 모드를 지정합니다.

기본값은 Normal입니다.

형식:	RunType
허용되는 값:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StandardProgramName

표준 프로그램 이름을 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-UserInteraction

사용자가 프로그램과 상호 작용할 수 있도록 허용할지 여부를 나타냅니다.

형식:	Boolean
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WorkingDirectory

프로그램의 작업 디렉터리를 지정합니다.

형식:	String
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

출력

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_Program 서버 WMI 클래스를 참조하세요.

관련 링크

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• Remove-CMProgram
• Set-CMProgram
• Configuration Manager의 패키지 및 프로그램