New-CMProgram
Создайте новую программу для пакета.
Синтаксис
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 .
| Type: | IResultObject[] |
| Aliases: | AddSupportedOperatingSystemPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLine
Укажите командную строку для программы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandLineFolder
Укажите папку, содержащую исполняемую программу. Эта папка может быть абсолютным путем на клиенте или путем относительно папки распространения, содержащей пакет.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Comment
Укажите необязательный текст о программе, например описание. На клиентских компьютерах этот текст отображается вместе с программой в Центре программного обеспечения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
Указывает имя программы устройства.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceRequirement
Укажите объем дискового пространства, необходимый программе для запуска на компьютере. Значение должно быть больше или равно нулю. Если задано значение, используйте параметр DiskSpaceUnit , чтобы указать единицы для значения.
| Type: | String |
| Aliases: | DiskSpaceReq |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSpaceUnit
Укажите принятую единицу для параметра DiskSpaceRequirement .
| Type: | DiskSpaceUnitType |
| Accepted values: | KB, MB, GB |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DownloadProgramType
Укажите время запуска программы.
| Type: | DownloadProgramType |
| Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriveLetter
Если используется параметр DriveMode , укажите букву диска для расположения.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DriveMode
Указывает, требуется ли программе определенная буква диска, указанная в параметре DriveLetter .
RunWithUnc: запустите программу из пути UNC. Это значение является значением по умолчанию. Начиная с версии 2010, это значение было переименовано сRenameWithUnc.RequiresDriveLetter: программа использует любую доступную букву диска.RequiresSpecificDriveLetter: программа запускается только в том случае, если диск еще не используется.
| Type: | DriveModeType |
| Accepted values: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Duration
Указывает максимальное время выполнения программы. По умолчанию установлено значение 120 минут.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
Укажите идентификатор пакета для этой программы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
Укажите имя пакета для этой программы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProgramRunType
Указывает условия входа, необходимые для запуска программы.
По умолчанию используется OnlyWhenUserIsLoggedOnпараметр .
| Type: | ProgramRunType |
| Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Reconnect
Указывает, будет ли клиентский компьютер повторно подключаться к точке распространения при входе пользователя в Windows.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Requirement
Задает дополнительные требования для стандартных программ или программ для устройств.
| Type: | String |
| Aliases: | Requirements |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunMode
Укажите учетные данные, необходимые программе для запуска на клиентском компьютере.
| Type: | RunModeType |
| Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunType
Укажите режим, в котором программа запускается на клиентском компьютере.
Значение по умолчанию — Normal.
| Type: | RunType |
| Accepted values: | Normal, Minimized, Maximized, Hidden |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
Укажите стандартное имя программы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserInteraction
Указывает, следует ли разрешить пользователям взаимодействовать с программой.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
Укажите рабочий каталог для программы.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Входные данные
None
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в разделе класс WMI сервера SMS_Program.
Связанные ссылки
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по