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

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

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

Примечание.

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

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

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

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

Из-за изменения структуры обновляемого содержимого, публикуемого в выпуске версии 2103, не используйте справку по обновлению на сайте версии 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, для модуля ConfigurationManager PowerShell требуется 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