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

Описание

Используйте этот командлет для создания программы для пакета. Программы — это команды, связанные с пакетом Configuration Manager. Они определяют действия, выполняемые при получении клиентом клиентского пакета. С тем же пакетом можно связать несколько программ. Дополнительные сведения см. в разделе Пакеты и программы в Configuration Manager.

Примечание.

Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Создание программы

В этом примере сначала параметры командлета объединяются в переменную parameters . Это не обязательно для splat параметры, это просто упрощает чтение параметров для такой длинной командной строки.

Эта команда создает программу с именем Scan x64 в пакете средства миграции пользовательской среды для Windows по умолчанию.

$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

Укажите одну или несколько поддерживаемых платформ ОС для добавления в программу. Чтобы получить этот объект, используйте командлет Get-CMSupportedPlatform .

Тип:	IResultObject[]
Aliases:	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

Перед запуском командлет запросит подтверждение.

Тип:	SwitchParameter
Aliases:	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

Укажите объем дискового пространства, необходимый программе для запуска на компьютере. Значение должно быть больше или равно нулю. Если задано значение, используйте параметр DiskSpaceUnit , чтобы указать единицы для значения.

Тип:	String
Aliases:	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

Укажите идентификатор пакета для этой программы.

Тип:	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
Aliases:	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

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WorkingDirectory

Укажите рабочий каталог для программы.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

None

Выходные данные

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в разделе SMS_Program класс WMI сервера.

Поделиться через

New-CMProgram

Синтаксис

Описание

Примеры

Пример 1. Создание программы

Параметры

-AddSupportedOperatingSystemPlatform

-CommandLine

-CommandLineFolder

-Comment

-Confirm

-DeviceProgramName

-DisableWildcardHandling

-DiskSpaceRequirement

-DiskSpaceUnit

-DownloadProgramType

-DriveLetter

-DriveMode

-Duration

-ForceWildcardHandling

-PackageId

-PackageName

-ProgramRunType

-Reconnect

-Requirement

-RunMode

-RunType

-StandardProgramName

-UserInteraction

-WhatIf

-WorkingDirectory

Входные данные

Выходные данные

Примечания

Обратная связь

Дополнительные ресурсы

Поделиться через

New-CMProgram

Синтаксис

Описание

Примеры

Пример 1. Создание программы

Параметры

-AddSupportedOperatingSystemPlatform

-CommandLine

-CommandLineFolder

-Comment

-Confirm

-DeviceProgramName

-DisableWildcardHandling

-DiskSpaceRequirement

-DiskSpaceUnit

-DownloadProgramType

-DriveLetter

-DriveMode

-Duration

-ForceWildcardHandling

-PackageId

-PackageName

-ProgramRunType

-Reconnect

-Requirement

-RunMode

-RunType

-StandardProgramName

-UserInteraction

-WhatIf

-WorkingDirectory

Входные данные

Выходные данные

Примечания

Связанные ссылки

Обратная связь

Дополнительные ресурсы