Поделиться через

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

  • Статья

Область применения: Configuration Manager (Current Branch)

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

Примечание

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

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

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

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

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

Командлет успешно скачает содержимое в консоль версии 2010, но Get-Help будет возвращать только сведения об использовании по умолчанию. Это происходит потому, что PowerShell не удается найти сведения о командлете в правильном XML-файле, который теперь отличается. Если вы использовали командлет Update-Help с сайтом версии 2010 (до выпуска версии 2103), теперь вы можете использовать командлет 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.

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

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

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

Поддержка Fast

Следующие командлеты теперь поддерживают параметр 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

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

Параметр референцедвариаблеоператор имеет другое возможное значение: NotLike .

New-CMTSStepConditionVariable

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

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

New-CMSoftwareUpdateAutoDeploymentRule

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

Исправлена проблема с параметром O365LanguageSelection. Теперь необходимо указать язык с названием страны. Благодаря этому изменению этот параметр согласован с параметрами в консоли Configuration Manager. Например -O365LanguageSelection "English (United States)".

Set-CMCertificateProfileScep

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

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

Set-CMClientPushInstallation

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

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

Set-CMCollection

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

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

Set-CMEmailProfile

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

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

Set-CMFallbackStatusPoint

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

Исправлено несоответствующее имя параметра.

Set-CMThirdPartyUpdateCatalog

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

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

$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 других аналогичных командлета.

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

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

Set-CMSoftwareUpdateAutoDeploymentRule

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

Исправлена проблема с параметром O365LanguageSelection. Теперь необходимо указать язык с названием страны. Благодаря этому изменению этот параметр согласован с параметрами в консоли Configuration Manager. Например -O365LanguageSelection "English (United States)".

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

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

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

Чтобы отправить новые запросы к функциям, см. группу PowerShell Configuration Manager в UserVoice.