Disable-CMProgram

Отключить программу в пакете.

Синтаксис

Disable-CMProgram
       -InputObject <IResultObject>
       [-PassThru]
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageId <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Disable-CMProgram
       -PackageName <String>
       [-PassThru]
       -ProgramName <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Описание

Используйте этот комдлет, чтобы отключить программу в пакете.

Отключение программы для предотвращения ее запуска клиентами Configuration Manager. При отключке программы диспетчер конфигурации по-прежнему распределяет содержимое пакета в точки распространения и отправляет развертывание программы клиентам. Клиент не отображает или не запустит программу на клиенте. При отключке развертывания программы такое же поведение.

Примечание

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

Примеры

Пример 1. Отключение программы

Эта команда отключает программу с именем ProgramD02 в пакете с ID XYZ00007.

Disable-CMProgram -PackageId "XYZ00007" -ProgramName "ProgramD02"

Параметры

- Название пакета

Укажите имя пакета с программой для отключения.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Укажите объект программы для отключения. Чтобы получить этот объект, используйте cmdlet Get-CMProgram.

Type:IResultObject
Aliases:Program
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

Укажите ID пакета с программой для отключения.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Добавьте этот параметр, чтобы вернуть объект, который представляет элемент, с которым вы работаете. По умолчанию этот комдлет может не создавать выходных данных.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ProgramName

Укажите имя пакета с программой для отключения.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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