Изменения библиотеки командлетов Configuration Manager для версии 2107
Область применения: Configuration Manager (Current Branch)
В этих заметках о выпуске приведена сводка изменений в библиотеке командлетов Configuration Manager в версии 2107.
Примечание
Configuration Manager Текущая ветвь версии 2103 является базовым для этих изменений. Дополнительные сведения см. в разделе изменения библиотеки командлетов 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-кмдеплойменттипеинсталлбехавиор.
Get-CMDeploymentTypeInstallBehavior
Используйте этот командлет, чтобы получить из указанного типа развертывания список исполняемых файлов, которые необходимо закрыть для успешной установки приложения.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt
Дополнительные сведения см. в разделе Get-кмдеплойменттипеинсталлбехавиор.
Remove-CMDeploymentTypeInstallBehavior
Используйте этот командлет, чтобы удалить из указанного типа развертывания исполняемые файлы, которые необходимо закрыть для успешной установки приложения.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"
Дополнительные сведения см. в разделе Remove-кмдеплойменттипеинсталлбехавиор.
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-кмдеплойменттипеинсталлбехавиор.
Управление кодами возврата для типов развертывания приложений
Этот набор новых командлетов предназначен для кодов возврата типов развертывания приложений. Дополнительные общие сведения см. в разделе Коды возврата для типа развертывания.
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-кмдеплойменттиперетурнкоде.
Get-CMDeploymentTypeReturnCode
Используйте этот командлет, чтобы получить список кодов возврата из указанного типа развертывания.
Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode
Дополнительные сведения см. в разделе Get-кмдеплойменттиперетурнкоде.
Remove-CMDeploymentTypeReturnCode
Используйте этот командлет, чтобы удалить коды возврата из указанного типа развертывания.
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602
Дополнительные сведения см. в разделе Remove-кмдеплойменттиперетурнкоде.
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-кмдеплойменттиперетурнкоде.
Другие новые командлеты
Get-CMClientSettingDeployment
С помощью этого командлета можно развернуть объект пользовательских параметров клиента. Этот объект можно использовать с Remove-кмклиентсеттингдеплоймент.
Дополнительные сведения о параметрах клиентов см. в статье Настройка параметров клиентов в Configuration Manager.
$clientSetting = Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment
Дополнительные сведения см. в разделе Get-кмклиентсеттингдеплоймент.
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-кмдеплойменттипедетектионклаусе.
Get-CMPersistentUserSettingsGroup
Используйте этот командлет, чтобы получить список сохраненных параметров на уровне сайта. Эти параметры используются на разных ваших устройствах.
Например, активные или отклоненные уведомления консоли Configuration Manager.
Дополнительные сведения см. в разделе Get-кмперсистентусерсеттингсграуп.
Get-CMSoftwareUpdateContentInfo
Используйте этот командлет для получения сведений о содержимом обновления программного обеспечения.
$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]
Дополнительные сведения см. в разделе Get-кмсофтвареупдатеконтентинфо.
Remove-CMPersistentUserSettingsGroup
Используйте этот командлет для сброса параметров на уровне сайта.
Например, вы можете восстановить отклоненные уведомления консоли Configuration Manager. После запуска этого командлета и перезапуска консоли Configuration Manager все доступные уведомления отобразятся снова.
Дополнительные сведения см. в разделе Remove-кмперсистентусерсеттингсграуп.
Устаревшие и удаленные командлеты
Следующие командлеты для запуска развертывания являются устаревшими и могут быть удалены в следующем выпуске:
| Нерекомендуемые командлеты | Замена |
|---|---|
| Start-CMApplicationDeploymentSimulation | New-кмаппликатиондеплоймент с параметром моделирования |
| 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-кмаппликатионграуп.
Исправленные ошибки
Исправлена проблема, из-за которой не удавалось получить правильный путь к группе приложений.
Get-CMDeploymentStatusDetails
Дополнительные сведения см. в разделе Get-кмдеплойментстатусдетаилс.
Исправленные ошибки
Исправлено условие запроса, чтобы избежать потенциальных проблем несоответствия типов.
Import-CMAntimalwarePolicy
Дополнительные сведения см. в разделе Import-кмантималвареполици.
Некритические изменения
Добавлена поддержка политики режима аудита с потенциально нежелательными приложениями. Дополнительные сведения см. в разделе режим аудита для потенциально нежелательных приложений.
Import-CMQuery
Дополнительные сведения см. в разделе Import-кмкуери.
Исправленные ошибки
Исправлена проблема, связанная с разблокировкой функции импорта.
New-CMAdministrativeUser
Дополнительные сведения см. в разделе New-кмадминистративеусер.
Исправленные ошибки
Исправлена проблема, когда имя пользователя — me .
New-CMApplicationDeployment
Дополнительные сведения см. в разделе New-кмаппликатиондеплоймент.
Некритические изменения
Добавлен параметр аутоклосиксекутабле , чтобы включить параметр развертывания приложения для поведения при установке.
New-CMCloudManagementGateway
Дополнительные сведения см. в разделе New-CMCloudManagementGateway.
Критические изменения
Параметр ServiceCertPassword необязателен.
New-CMMigrationJob
Дополнительные сведения см. в разделе New-кммигратионжоб.
Исправленные ошибки
Разблокирован Перенос объектов развертывания распространения программного обеспечения.
New-CMSecondarySite
Дополнительные сведения см. в разделе New-cmprestagecontent.
Критические изменения
Изменено минимальное свободное пространство по умолчанию с 200 МБ до 500 МБ.
New-CMSoftwareUpdateAutoDeploymentRule
Дополнительные сведения см. в статье New-CMSoftwareUpdateAutoDeploymentRule.
Исправленные ошибки
Исправлена проблема с параметром продукта . Если существует несколько продуктов с одинаковым именем, все они будут выбраны.
New-CMSoftwareUpdateDeployment
Дополнительные сведения см. в разделе New-кмсофтвареупдатедеплоймент.
Некритические изменения
В параметр Комментарий добавлен псевдоним Описание.
New-CMTaskSequence
Дополнительные сведения см. в описании New-CMTaskSequence.
Некритические изменения
Максимальная длина параметра Description увеличена до
512символов.Добавлен новый параметр HighPerformance для поддержки настройки производительности.
Удален устаревший параметр InstallationLicensingMode.
Удален набор параметров невинсталлосимажевхд .
Удален параметр инсталлоператингсистемимажевхд .
New-CMTaskSequenceDeployment
Дополнительные сведения см. в разделе New-кмтасксекуенцедеплоймент.
Исправленные ошибки
Исправлена проблема с высокопроизводительными схемами управления питанием.
New-CMTSStepApplyDriverPackage
Дополнительные сведения см. в разделе New-кмтсстепапплидриверпаккаже.
Некритические изменения
Добавлено условие для проверки пакета для указанного PackageId.
New-CMTSStepApplyOperatingSystem
Дополнительные сведения см. в описании New-CMTSStepApplyOperatingSystem.
Исправленные ошибки
Исправлены проблемы с проверкой, которые происходили при использовании параметра DestinationVariable для разрешения значений, начинающихся с символа подчеркивания (_).
Некритические изменения
Добавлен параметр лайереддривер для поддержки многоуровневой версии драйвера клавиатуры во время развертывания ОС.
New-CMTSStepUpgradeOperatingSystem
Дополнительные сведения см. в разделе New-кмтсстепупградеоператингсистем.
Некритические изменения
Добавлен новый параметр SoftwareUpdate для указания обновления компонентов для шага последовательности задач Обновление ОС.
Publish-CMPrestageContent
Дополнительные сведения см. в статье Publish-кмпрестажеконтент.
Исправленные ошибки
Исправлена потенциальная ошибка недопустимого объекта.
Remove-CMApplicationGroup
Дополнительные сведения см. в разделе Remove-кмаппликатионграуп.
Исправленные ошибки
Исправлена проблема, из-за которой не удавалось правильный путь к группе приложений при использовании конвейера.
Set-CMAntimalwarePolicy
Дополнительные сведения см. в разделе Set-кмантималвареполици.
Некритические изменения
Добавлен параметр пуапротектион для поддержки потенциально нежелательных приложений.
Set-CMApplicationDeployment
Дополнительные сведения см. в разделе Set-кмаппликатиондеплоймент.
Некритические изменения
Добавлен параметр аутоклосиксекутабле , чтобы включить параметр развертывания приложения для поведения при установке.
Set-CMClientSetting
Дополнительные сведения см. в разделе Set-кмклиентсеттинг.
Некритические изменения
Добавлено понятное сообщение об устаревании для параметра SoftwareMetering.
Set-CMClientSettingSoftwareUpdate
Дополнительные сведения см. в разделе Set-кмклиентсеттингсофтвареупдате.
Некритические изменения
Добавлен параметр енаблевсусцертпиннинг для поддержки закрепления сертификата.
Set-CMDeploymentType
Дополнительные сведения см. в статье Set-CMDeploymentType.
Исправленные ошибки
Исправлена проблема с параметром AddRequirement для добавления новых правил.
Set-CMMsiDeploymentType
Дополнительные сведения см. в разделе Set-кммсидеплойменттипе.
Исправленные ошибки
Обновлен тип развертывания в соответствии с типом установщика, что позволяет избежать сброса конфигураций при изменении расположения содержимого.
Некритические изменения
Добавлена поддержка для указания пути к папке для параметра ContentLocation.
Set-CMTaskSequence
Дополнительные сведения см. в разделе Set-кмтасксекуенце.
Некритические изменения
Добавлен новый параметр HighPerformance для поддержки параметра производительности для последовательности задач.
Set-CMTSStepApplyDriverPackage
Дополнительные сведения см. в разделе Set-кмтсстепапплидриверпаккаже.
Некритические изменения
Добавлено условие для проверки пакета для указанного PackageId.
Set-CMTSStepApplyOperatingSystem
Дополнительные сведения см. в разделе Set-кмтсстепапплйоператингсистем.
Исправленные ошибки
Исправлена проблема с параметром назначения .
Некритические изменения
Добавлен параметр лайереддривер для поддержки многоуровневой версии драйвера клавиатуры во время развертывания ОС.
Set-CMTSStepUpgradeOperatingSystem
Дополнительные сведения см. в разделе Set-кмтсстепупградеоператингсистем.
Некритические изменения
Добавлен новый параметр SoftwareUpdate для указания обновления компонентов для шага последовательности задач Обновление ОС.
Start-CMDistributionPointUpgrade
Дополнительные сведения см. в разделе Start-кмдистрибутионпоинтупграде.
Критические изменения
Задайте для параметра Минимальный объем свободного пространства по умолчанию значение 500 МБ.
Update-CMDistributionPoint
Дополнительные сведения см. в статье Update-CMDistributionPoint.
Исправленные ошибки
Исправлена проблема с обновлением содержимого из папок установки и удаления, если они отличаются.
Как отправить отзыв или сообщить о проблемах
Многие исправления и улучшения, описанные в этой статье, являются результатом ваших отзывов.
Чтобы отправить отзыв, используйте консоль Configuration Manager. Дополнительные сведения см. в статье обратная связь для PowerShell.
Чтобы отправить новые запросы к функциям, см. группу PowerShell Configuration Manager в UserVoice.