Изменения библиотеки командлетов Configuration Manager для версии 2107

Относится к Configuration Manager (Current Branch)

В этих примечаниях к выпуску кратко описаны изменения, внесенные в библиотеку командлетов Configuration Manager в версии 2107.

Примечание.

Версия 2103 Current Branch Configuration Manager является основой для этих изменений. Дополнительные сведения см. в статье Изменения библиотеки командлетов Configuration Manager для версии 2103.

Новые командлеты для типов развертывания приложений

Управление поведением установки для типов развертывания приложений

Этот набор новых командлетов предназначен для поведения при установке типа развертывания приложения. Дополнительные общие сведения о функции поведения при установке см. в разделе Проверка выполнения исполняемых файлов.

Add-CMDeploymentTypeInstallBehavior

Используйте этот командлет, чтобы добавить в указанный тип развертывания исполняемые файлы, которые должны быть закрыты для успешной установки приложения.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

Дополнительные сведения см. в Add-CMDeploymentTypeInstallBehavior.

Get-CMDeploymentTypeInstallBehavior

Используйте этот командлет, чтобы получить из указанного типа развертывания список исполняемых файлов, которые должны быть закрыты для успешной установки приложения.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

Дополнительные сведения см. в разделе Get-CMDeploymentTypeInstallBehavior.

Remove-CMDeploymentTypeInstallBehavior

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

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

Дополнительные сведения см. в разделе Remove-CMDeploymentTypeInstallBehavior.

Set-CMDeploymentTypeInstallBehavior

Используйте этот командлет для изменения исполняемых файлов, которые требуется закрыть для успешной установки приложения.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Дополнительные сведения см. в разделе Set-CMDeploymentTypeInstallBehavior.

Управление кодами возврата для типов развертывания приложений

Этот набор новых командлетов предназначен для кодов возврата типа развертывания приложения. Дополнительные сведения см. в статье Коды возврата типа развертывания.

Add-CMDeploymentTypeReturnCode

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

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

Дополнительные сведения см. в разделе Add-CMDeploymentTypeReturnCode.

Get-CMDeploymentTypeReturnCode

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

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

Дополнительные сведения см. в статье Get-CMDeploymentTypeReturnCode.

Remove-CMDeploymentTypeReturnCode

Используйте этот командлет для удаления кодов возврата из указанного типа развертывания.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

Дополнительные сведения см. в разделе Remove-CMDeploymentTypeReturnCode.

Set-CMDeploymentTypeReturnCode

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

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

Дополнительные сведения см. в разделе Set-CMDeploymentTypeReturnCode.

Другие новые командлеты

Get-CMClientSettingDeployment

Используйте этот командлет, чтобы развернуть настраиваемый объект параметров клиента. Этот объект можно использовать с Remove-CMClientSettingDeployment.

Дополнительные сведения о параметрах клиента см. в разделе Настройка параметров клиента.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

Дополнительные сведения см. в разделе Get-CMClientSettingDeployment.

Get-CMDeploymentTypeDetectionClause

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

С помощью этого командлета можно получить предложение обнаружения из одного приложения и применить его к другому, например:

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

Дополнительные сведения см. в разделе Get-CMDeploymentTypeDetectionClause.

Get-CMPersistentUserSettingsGroup

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

Например, уведомления консоли Configuration Manager, которые активны или закрыты.

Дополнительные сведения см. в разделе Get-CMPersistentUserSettingsGroup.

Get-CMSoftwareUpdateContentInfo

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

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

Дополнительные сведения см. в разделе Get-CMSoftwareUpdateContentInfo.

Remove-CMPersistentUserSettingsGroup

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

Например, вы можете восстановить закрытые уведомления консоли Configuration Manager. После запуска этого командлета и перезапуска консоли Configuration Manager вы снова увидите все доступные уведомления.

Дополнительные сведения см. в разделе Remove-CMPersistentUserSettingsGroup.

Устаревшие и удаленные командлеты

Следующие командлеты для запуска развертывания являются нерекомендуемыми и могут быть удалены в следующем выпуске:

Нерекомендуемый командлет	Замена
Start-CMApplicationDeploymentSimulation	New-CMApplicationDeployment с параметром Simulation
Start-CMClientSettingDeployment	New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment	New-CMAntimalwarePolicyDeployment

Следующие командлеты больше не доступны, так как базовые функции больше не поддерживаются:

• Add-CMApplicationCatalogWebServicePoint

• Add-CMApplicationCatalogWebsitePoint

• Get-CMApplicationCatalogWebServicePoint

• Get-CMApplicationCatalogWebsitePoint

• Remove-CMApplicationCatalogWebServicePoint

• Remove-CMApplicationCatalogWebsitePoint

• Set-CMApplicationCatalogWebsitePoint

• Get-CMVhd

• New-CMVhd

• Remove-CMVhd

• Set-CMVhd

Изменения командлетов

В существующие командлеты в этой версии внесены указанные ниже изменения. Изменения могут включать новые функции или исправления ошибок. Некоторые изменения могут быть критически важными. Если вы используете один из командлетов или функциональных областей, перечисленных в этом разделе, внимательно изучите изменения, чтобы понять, как они могут повлиять на вашу работу.

Add-CMDeviceCollectionDirectMembershipRule

Дополнительные сведения см. в Add-CMDeviceCollectionDirectMembershipRule.

Исправленные ошибки

Исправлена проблема при попытке добавить тысячи устройств в качестве правил прямого членства.

Add-CMDistributionPoint

Дополнительные сведения см. в разделе Add-CMDistributionPoint.

Критические изменения

Минимальный объем свободного пространства по умолчанию изменен с 50 МБ на 500 МБ.

Add-CMTaskSequenceStep

Дополнительные сведения см. в разделе Add-CMTaskSequenceStep.

Некритические изменения

Удален ненужный параметр StepName.

Disconnect-CMTrackedObject

Дополнительные сведения см. в разделе Disconnect-CMTrackedObject.

Некритические изменения

Для этого командлета добавлен псевдоним Disconnect-CMObject .

Get-CMApplicationGroup

Дополнительные сведения см. в разделе Get-CMApplicationGroup.

Исправленные ошибки

Исправлена проблема, связанная с получением правильного пути к группе приложений.

Get-CMDeploymentStatusDetails

Дополнительные сведения см. в разделе Get-CMDeploymentStatusDetails.

Исправленные ошибки

Исправлено условие запроса, чтобы избежать потенциальных проблем с несоответствием типов.

Import-CMAntimalwarePolicy

Дополнительные сведения см. в разделе Import-CMAntimalwarePolicy.

Некритические изменения

Добавлена поддержка политики режима аудита с потенциально нежелательными приложениями. Дополнительные сведения см. в разделе "Режим аудита для потенциально нежелательных приложений".

Import-CMQuery

Дополнительные сведения см. в разделе Import-CMQuery.

Исправленные ошибки

Исправлена проблема с разблокировкой функции импорта.

New-CMAdministrativeUser

Дополнительные сведения см. в разделе New-CMAdministrativeUser.

Исправленные ошибки

Исправлена проблема, если именем пользователя является me.

New-CMApplicationDeployment

Дополнительные сведения см. в статье New-CMApplicationDeployment.

Некритические изменения

Добавлен параметр AutoCloseExecutable для включения параметра развертывания приложения для поведения, связанного с установкой.

New-CMCloudManagementGateway

Дополнительные сведения см. в разделе New-CMCloudManagementGateway.

Критические изменения

Параметр ServiceCertPassword теперь является обязательным.

New-CMMigrationJob

Дополнительные сведения см. в статье New-CMMigrationJob.

Исправленные ошибки

Разблокирована миграция объектов развертывания распространения программного обеспечения.

New-CMSecondarySite

Для получения дополнительной информации см. New-CMSecondarySite.

Критические изменения

Минимальный объем свободного пространства по умолчанию изменен с 200 МБ на 500 МБ.

New-CMSoftwareUpdateAutoDeploymentRule

Дополнительные сведения см. в статье New-CMSoftwareUpdateAutoDeploymentRule.

Исправленные ошибки

Исправлена проблема с параметром Product . Теперь при наличии нескольких продуктов с одинаковым именем будет выбран каждый из них.

New-CMSoftwareUpdateDeployment

Дополнительные сведения см. в статье New-CMSoftwareUpdateDeployment.

Некритические изменения

Добавлен псевдоним описания в параметр Comment .

New-CMTaskSequence

Дополнительные сведения см. в статье New-CMTaskSequence.

Некритические изменения

• Максимальная длина параметра Description теперь распространяется на 512 символы.

• Добавлен новый параметр HighPerformance для поддержки настройки производительности.

• Устаревший параметр InstallationLicensingMode был удален.

• Удален набор параметров NewInstallOSImageVhd .

• Удален параметр InstallOperatingSystemImageVhd.

New-CMTaskSequenceDeployment

Дополнительные сведения см. в статье New-CMTaskSequenceDeployment.

Исправленные ошибки

Исправлена проблема с высокопроизводительными схемами управления питанием.

New-CMTSStepApplyDriverPackage

Дополнительные сведения см. в разделе New-CMTSStepApplyDriverPackage.

Некритические изменения

Добавлено условие для проверки пакета на предмет указанного идентификатора PackageId.

New-CMTSStepApplyOperatingSystem

Дополнительные сведения см. в разделе New-CMTSStepApplyOperatingSystem.

Исправленные ошибки

Устранены проблемы проверки параметров DestinationVariable , разрешающих значения, начинающиеся с символа подчеркивания (_).

Некритические изменения

Добавлен параметр LayeredDriver для поддержки драйвера многоуровневой клавиатуры во время развертывания операционной системы.

New-CMTSStepUpgradeOperatingSystem

Дополнительные сведения см. в разделе New-CMTSStepUpgradeOperatingSystem.

Некритические изменения

Добавлен новый параметр SoftwareUpdate для указания обновления компонентов на этапе последовательности задач обновления ОС .

Publish-CMPrestageContent

Дополнительные сведения см. в разделе Publish-CMPrestageContent.

Исправленные ошибки

Исправлена проблема с потенциально недопустимым объектом.

Remove-CMApplicationGroup

Дополнительные сведения см. в разделе Remove-CMApplicationGroup.

Исправленные ошибки

Исправлена проблема с получением правильного пути к группе приложений при использовании конвейера.

Set-CMAntimalwarePolicy

Дополнительные сведения см. в разделе Set-CMAntimalwarePolicy.

Некритические изменения

Добавлен параметр PuaProtection для поддержки потенциально нежелательных приложений.

Set-CMApplicationDeployment

Дополнительные сведения см. в разделе Set-CMApplicationDeployment.

Некритические изменения

Добавлен параметр AutoCloseExecutable для включения параметра развертывания приложения для поведения, связанного с установкой.

Set-CMClientSetting

Дополнительные сведения см. в разделе Set-CMClientSetting.

Некритические изменения

Добавлено значимое сообщение о прекращении поддержки для параметра SoftwareMetering .

Set-CMClientSettingSoftwareUpdate

Дополнительные сведения см. в разделе Set-CMClientSettingSoftwareUpdate.

Некритические изменения

Добавлен параметр EnableWsusCertPinning для поддержки закрепления сертификатов.

Set-CMDeploymentType

Дополнительные сведения см. в разделе Set-CMDeploymentType.

Исправленные ошибки

Исправлена проблема с параметром AddRequirement для добавления новых правил.

Set-CMMsiDeploymentType

Дополнительные сведения см. в разделе Set-CMMsiDeploymentType.

Исправленные ошибки

Обновите тип развертывания в соответствии с типом установщика, чтобы избежать сброса конфигураций при изменении расположения содержимого.

Некритические изменения

Добавлена поддержка указания пути к папке в параметре ContentLocation .

Set-CMTaskSequence

Дополнительные сведения см. в разделе Set-CMTaskSequence.

Некритические изменения

Добавлен новый параметр HighPerformance для поддержки настройки производительности последовательности задач.

Set-CMTSStepApplyDriverPackage

Дополнительные сведения см. в разделе Set-CMTSStepApplyDriverPackage.

Некритические изменения

Добавлено условие для проверки пакета на предмет указанного идентификатора PackageId.

Set-CMTSStepApplyOperatingSystem

Дополнительные сведения см. в разделе Set-CMTSStepApplyOperatingSystem.

Исправленные ошибки

Исправлена проблема с параметром Destination .

Некритические изменения

Добавлен параметр LayeredDriver для поддержки драйвера многоуровневой клавиатуры во время развертывания операционной системы.

Set-CMTSStepUpgradeOperatingSystem

Дополнительные сведения см. в разделе Set-CMTSStepUpgradeOperatingSystem.

Некритические изменения

Добавлен новый параметр SoftwareUpdate для указания обновления компонентов на этапе последовательности задач обновления ОС .

Start-CMDistributionPointUpgrade

Дополнительные сведения см. в разделе Start-CMDistributionPointUpgrade.

Критические изменения

Установите минимальный объем свободного пространства по умолчанию на 500 МБ.

Update-CMDistributionPoint

Дополнительные сведения см. в разделе Update-CMDistributionPoint.

Исправленные ошибки

Исправлена проблема с обновлением содержимого из папок установки и удаления, если они отличались.

Как оставить отзыв или сообщить о проблемах

Многие исправления и улучшения, описанные в этой статье, являются результатом ваших отзывов.

Для отправки отзывов используйте консоль Configuration Manager. Дополнительные сведения см. в разделе "Отзывы о PowerShell".