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

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

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

Примечание.

Configuration Manager текущая версия ветви 2010 является базовым показателем для этих изменений. Дополнительные сведения см. в разделе Configuration Manager изменения библиотеки командлетов для версии 2010.

Известная проблема с обновляемой справкой PowerShell

Начиная с версии 2010, можно использовать командлет Update-Help, чтобы скачать последние сведения для модуля PowerShell Configuration Manager.

В версии 2103 структура модуля PowerShell изменилась с 29 библиотек DLL на два. Файлы справки PowerShell XML связаны с библиотекой DLL для командлетов. Таким образом, содержимое справки версии 2010 несовместимо с консолью версии 2103, а содержимое справки версии 2103 несовместимо с консолью версии 2010.

Из-за этого изменения структуры и публикации обновляемого содержимого в выпуске версии 2103 не используйте Update-Help на сайте версии 2010. Обновите сайт до версии 2103, а затем обновите содержимое локальной справки.

Командлет успешно скачит содержимое на консоль версии 2010, но Get-Help вернет только сведения об использовании по умолчанию. Это связано с тем, что PowerShell не может найти сведения о командлете в правильном XML-файле, который теперь отличается. До выпуска версии 2103, если вы использовали Update-Help с сайтом версии 2010, вы можете продолжать использовать Get-Help .

Аналогичным образом, если вы использовали Update-Help на сайте версии 2010, после обновления до версии 2103 снова запустите Update-Help , чтобы получить совместимую версию содержимого справки. В противном случае Get-Help вернет только сведения об использовании по умолчанию.

Примечание.

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

Модуль PowerShell

Если консоль Configuration Manager на устройстве еще не подключена к сайту, при импорте модуля ConfigurationManager вручную создается диск PowerShell для сайта на основе поставщика SMS по умолчанию.

Начиная с версии 2103 для модуля PowerShell ConfigurationManager требуется Microsoft .NET версии 4.7.2 или более поздней.

Командлеты, которые не поддерживают PowerShell версии 7

Хотя Configuration Manager командлеты обеспечивают общую поддержку PowerShell версии 7, следующие командлеты не поддерживают PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Для них требуется платформа .NET Framework вместо .NET Core, используемой с PowerShell версии 7.

Начиная с версии 2103, при попытке использовать эти командлеты в сеансе PowerShell версии 7 они завершаются ошибкой: This cmdlet only supports the ".NET Framework" runtime.

Новые командлеты

  • Get-CMApplicationGroup: используйте этот командлет для получения группы приложений.
  • Get-CMDuplicateHardwareIdGuid: получение повторяющихся идентификаторов оборудования по GUID.
  • Get-CMDuplicateHardwareIdMacAddress: получение повторяющихся идентификаторов оборудования по MAC-адресу.
  • New-CMApplicationGroup: используйте этот командлет для создания новой группы приложений.
  • Publish-CMThirdPartySoftwareUpdateContent: используйте этот командлет для публикации содержимого сторонних обновлений.
  • Remove-CMApplicationGroup: используйте этот командлет, чтобы удалить определенную группу приложений.
  • Remove-CMClientSettingDeployment: используйте этот командлет, чтобы удалить определенное развертывание параметра клиента.
  • Set-CMApplicationGroup: используйте этот командлет для настройки определенной группы приложений.
  • Set-CMCISupportedPlatform: используйте этот командлет для настройки платформ для элемента конфигурации.
  • Sync-CMCloudManagementGateway. Синхронизируйте конфигурацию шлюза управления облаком (CMG) с Azure.

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

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

Быстрая поддержка

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

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Некримитные изменения

Исправлено несогласованное имя параметра.

Copy-CMCollection

Некримитные изменения

Исправлена проверка с параметром NewName для выравнивания по консоли.

Get-CMDeploymentStatusDetails

Некримитные изменения

  • Исправлена проблема проверки типов входных объектов для таких типов, как SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus и SMS_DCMDeploymentCompliantStatus.
  • Исправлена проблема с недопустимым типом класса вывода путем изменения типа объекта вывода SMS_AppDeploymentRequirementsNotMetStatus на SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Для получения дополнительных сведений об ошибке изменен тип выходного объекта с SMS_AppDeploymentAssetDetails на SMS_AppDeploymentErrorAssetDetails .
  • Добавлен тип входного объекта SMS_UpdateDeploymentSummary , чтобы этот командлет смог получать сведения о развертывании обновлений. При передаче выходных данных Get-CMSoftwareUpdateDeploymentStatus в Get-CMDeploymentStatusDetails он возвращает сведения о развертывании из SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Некримитные изменения

Добавлена возможность фильтрации по параметру AdministrativeCategory.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Некримитные изменения

Добавлен параметр PackageType для получения определенного типа пакета.

Get-CMSoftwareUpdateDeployment

Некримитные изменения

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

New-CMApplication

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

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

New-CMCertificateProfileScep

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

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

New-CMCollection

Некримитные изменения

Исправлена проверка с параметром Name для выравнивания по консоли.

New-CMOperatingSystemImage

Некримитные изменения

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

New-CMOperatingSystemInstaller

Некримитные изменения

Добавлен параметр Index. При добавлении этого параметра сайт заменяет текущий образ с несколькими индексами новым изображением с одним индексом.

New-CMTSRule

Некримитные изменения

Параметр ReferencedVariableOperator имеет другое возможное значение: NotLike.

New-CMTSStepConditionVariable

Некримитные изменения

Параметр OperatorType имеет другое возможное значение: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

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

Исправлена проблема с параметром O365LanguageSelection. Теперь необходимо указать язык с именем страны или региона. Это изменение сопоставляет этот параметр с параметрами в консоли Configuration Manager. Пример: -O365LanguageSelection "English (США)"

Set-CMCertificateProfileScep

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

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

Set-CMClientPushInstallation

Некримитные изменения

Добавьте параметр AllownNTLMFallback , чтобы включить откат NTLM.

Set-CMCollection

Некримитные изменения

Исправлена проверка с параметром NewName для выравнивания по консоли.

Set-CMEmailProfile

Некримитные изменения

  • Исправлена проблема с параметром NewName при указании sAMAccountName в качестве имени пользователя учетной записи.
  • Исправлена проблема с параметрами при разрешении DomainName.

Set-CMFallbackStatusPoint

Некримитные изменения

Исправлено несогласованное имя параметра.

Set-CMThirdPartyUpdateCatalog

Некримитные изменения

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

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Некримитные изменения

Исправлена проблема с параметром PublishOption , для которой задано значение FullContent.

Set-CMTSStep*

Например, Set-CMTSStepApplyDataImage и 34 других аналогичных командлета.

Некримитные изменения

Параметр OperatorType имеет другое возможное значение: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

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

Исправлена проблема с параметром O365LanguageSelection. Теперь необходимо указать язык с названием страны. Это изменение сопоставляет этот параметр с параметрами в консоли Configuration Manager. Пример: -O365LanguageSelection "English (США)"

Предоставление отзывов или сообщение о проблемах

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

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

  • Last updated on