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

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

  • Статья

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

Примечание.

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

Важные изменения

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

Get-CMBoundaryGroupSiteSystem

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

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID

Get-CMDistributionPointDriveInfo

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

$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName 
$dp | Get-CMDistributionPointDriveInfo

Invoke-CMAnalyzePackage

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

Invoke-CMAnalyzePackage -PackageName $packageName

Invoke-CMConvertPackage

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

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

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

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1

Set-CMClientSettingDeliveryOptimization

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

[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true

Set-CMClientSettingWindowsAnalytics

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

[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones

Удалены командлеты

Нет

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

Нет

Известные проблемы

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

Get-CMAadConditionalAccessPolicy и Set-CMAadConditionalAccessPolicy

Для этих командлетов требуется 64-разрядная среда PowerShell.

Обходной путь

  • Нет

Import-CMSecurityRole

Командлет может завершиться ошибкой DirectoryNotFoundException при обнаружении файла SecuredRoles.xsd.

Обходной путь

  • ConfigurationManager.psd1 Вызовите Import-Module файл, а не логический путь или имя модуля.

Set-CMSoftwareUpdatePoint

Изменения в расписании могут не отображаться в консоли Configuration Manager, даже если базовый объект поставщика SMS был изменен.

Обходной путь

  • Закройте и перезапустите консоль Configuration Manager.

Отслеживание и восстановление ресурсов (бета-версия)

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

  • Disconnect-CMTrackedObject
  • Start-CMObjectTracking
  • Stop-CMObjectTracking

При запуске Start-CMObjectTrackingсреда выполнения PowerShell отслеживает IResultObject объекты, созданные командлетами библиотеки командлетов. Для командлетов, которые не очищаются вручную с .Dispose()помощью , они восстанавливаются с помощью отдельного Disconnect-CMTrackedObject объекта.

Пример

# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

После восстановления объекта его больше нельзя использовать повторно или передать другому командлету через конвейер объектов.

Stop-CMObjectTracking можно использовать для отключения отслеживания объектов. Ранее выделенные объекты остаются активными.

Невостребованные ресурсы могут вызвать ошибки нарушения квоты у поставщика SMS. Эти проблемы с квотами обычно возникают при работе с большими наборами объектов поставщика SMS или в длительных средах.

Примечание.

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

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

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

Add-CMDeviceAffinityToUser

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

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName требует совместного использования "-DeviceId/-DeviceName".

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

  • Добавлена проверка параметров для -DeviceID и -DeviceName, пользователь должен указать по крайней мере один из них.

Add-CMDeviceCollectionDirectMembershipRule

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

  • При добавлении одного и того же ресурса в ту же коллекцию с помощью команды Add-CMDeviceCollectionDirectMembershipRule в PowerShell отображается пустое предупреждение "WARNING: " и не выводится сообщение об ошибке "Объект с указанным именем уже существует".

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

  • Добавлен отсутствующий ресурс.

Add-CMDistributionPoint

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

  • Добавлен параметр -EnableLedbat для включения или отключения LEDBAT в DP

Add-CMScriptDeploymentType

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

  • Add-CMScriptDeploymentType по умолчанию не соответствуют пользовательскому интерфейсу

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

  • Изменен код инициализации в соответствии с пользовательским интерфейсом (предполагаемое время установки = 0, требование входа = только при входе пользователя).

Approve-CMApprovalRequest

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

  • Добавлен новый параметр InstallActionBehavior (имеет два параметра: InstallNow, InstallNonBusinessHours), администратор может указать, следует ли устанавливать приложение сразу после его утверждения или установки в нерабочее время. Это необязательный параметр, по умолчанию равный InstallNow.

Get-CMDevice

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

  • Get-CMDevice отсутствует свойство SMSAssignedSites . Это было доступно до 1806.

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

  • Добавлены два новых параметра переключателя, позволяющих клиенту указать класс выходных данных:

    • -ReturnCollectionMember: принудительно вернет экземпляр класса-члена коллекции sms.
    • -ReturnResource: принудительно возвращает экземпляр класса SMS_Resource.

    Если вы используете параметр по умолчанию без ReturnCollectionMember/ReturnResource, поведение будет таким же, как 1802/1810: возвращаемый экземпляр может находиться в разных классах с разными заданными параметрами.

Get-CMPackage

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

  • Get-CMPackage требуется быстрый переключатель

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

  • Добавлен параметр -Fast для поддержки быстрых запросов.

Import-CMDriver

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

  • Set-CMDriver —SupportedPlatformName завершится сбоем для массивов

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

  • Исправлена проблема со значением массива для параметра SupportPlatformName.

Invoke-CMScript

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

  • Invoke-CMScript командлет ожидает объект, который невозможно получить.

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

  • Исправлена проверка типа.

New-CMActiveDirectoryForest

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

  • Создание леса Active Directory. Пользователь не работает с помощью PowerShell, только если он создан с помощью графического пользовательского интерфейса пользователя.

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

  • Импорт учетной записи в глобальную учетную запись после установки пользователем учетных данных.
  • Добавлен новый параметр -Password для создания учетных данных с паролем.

New-CMApplication

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

  • Пользователь не может указать пустой параметр Owner или SupportContact с помощью командлета New-CMApplication

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

  • Разрешить $null для владельца или поддержкиContact при создании нового приложения. Значение по умолчанию будет текущий пользователь.
  • Добавлены новые параметры для Owner/SupportContact для поддержки входных данных массива.

New-CMApplicationDeployment

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

  • Добавлен новый параметр ReplaceToastNotificationWithDialog (Boolean). Администратор может указать, следует ли заменять всплывающие уведомления диалоговым окном, когда на клиентском компьютере станет доступно необходимое программное обеспечение. Это необязательный параметр и значение false по умолчанию.

New-CMCoManagementPolicy

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

  • Добавлена поддержка новых рабочих нагрузок (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).

New-CMDetectionClauseWindowsInstaller

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

  • Сбой add/Set-CMMsiDeploymentType -AddDetectionClause: недопустимое выражение: либо тип данных операнда не соответствует, либо оператор недопустим для типа данных.

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

  • Изменена логика инициализации типа данных, чтобы убедиться, что она правильна при указании параметра Существования.

New-CMOperatingSystemImageUpdateSchedule

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

  • Добавлен новый параметр для сопоставления изменений, внесенных в мастер создания расписаний в пользовательском интерфейсе:
    • -RemoveSupersedUpdates

New-CMOperatingSystemUpgradeUpdateSchedule

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

  • Добавлен новый параметр для сопоставления изменений, внесенных в мастер создания расписаний в пользовательском интерфейсе:
    • -RemoveSupersedUpdates

New-CMPackageDeployment

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

  • New-CMPackageDeployment содержит несогласованные предупреждения

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

  • Изменено поведение по умолчанию параметра SlowNetwork для согласования с пользовательским интерфейсом.

New-CMStatusFilterRule

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

  • New-CMStatusFilterRule не работает должным образом
  • Не удалось создать новое правило фильтра состояния со свойством "Идентификатор пакета.

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

  • Добавлено дополнительное условие для проверки идентификатора или значения свойства, чтобы разблокировать регистр без указания -PropertyID.
  • Добавлена логика, позволяющая пользователю задать идентификатор свойства = "Идентификатор пакета", если источником является "Клиент".

New-CMTaskSequenceDeployment

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

  • Не удается задать время окончания срока действия развертывания последовательности задач
  • New-CMTaskSequenceDeployment $result не удается получить объект из этого командлета.

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

  • Добавлен псевдоним DeploymentExpireDateTime для параметра -DeadlineDateTime для согласования с командлетом Set.
  • При удалении блока using объект развертывания не должен быть удален.

New-CMTaskSequenceMedia

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

  • Добавлен новый параметр в соответствии с изменениями, добавленными в пользовательский интерфейс создания носителя последовательности задач:
    • -TemporaryFolder (псевдоним "TemporaryDirectory", "StagingArea")

New-CMTSStepRunPowerShellScript

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

  • Добавлены наборы параметров: RunScriptFromSource, RunScriptFromPackage.
  • Параметры PackageID и PackageName больше не являются обязательными, так как пользователи могут ввести новый параметр SourceScript.

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

  • Новые параметры, добавленные для сопоставления изменений, внесенных в шаг запуска скрипта Power Shell в пользовательском интерфейсе редактора последовательности задач:
    • -SourceCode
    • -Workingdirectory
    • -OutputVariableName
    • -Времени ожидания
    • -Пользователя
    • -Пароль
    • -SuccessCodes

Remove-CMDeviceAffinityFromUser

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

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName требует совместного использования "-DeviceId/-DeviceName".

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

  • Добавлена проверка параметров для -DeviceID и -DeviceName, пользователь должен указать по крайней мере один из них.

Set-CMActiveDirectoryForest

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

  • Создание леса Active Directory. Пользователь не работает с помощью PowerShell, только если он создан с помощью графического пользовательского интерфейса пользователя.

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

  • Импорт учетной записи в глобальную учетную запись после установки пользователем учетных данных.
  • Добавлен новый параметр -Password для создания учетных данных с паролем.

Set-CMApplicationDeployment

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

  • Добавлен новый параметр ReplaceToastNotificationWithDialog (Boolean). Администратор может указать, следует ли заменять всплывающие уведомления диалоговым окном, когда на клиентском компьютере станет доступно необходимое программное обеспечение. Это необязательный параметр и значение false по умолчанию.

Set-CMClientSetting

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

  • Добавлен новый параметр ReplaceToastNotificationWithDialog (Boolean). Администратор может указать, следует ли заменять всплывающие уведомления диалоговым окном, когда компьютер требует перезагрузки. Это необязательный параметр и значение false по умолчанию.

Set-CMClientSettingComputerRestart

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

  • Добавлен новый параметр ReplaceToastNotificationWithDialog (Boolean). Администратор может указать, следует ли заменять всплывающие уведомления диалоговым окном, когда компьютер требует перезагрузки. Это необязательный параметр и значение false по умолчанию.

Set-CMComplianceRuleExistential

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

  • Set-CMComplianceRuleExistential -Rule не позволяет задать значение правила.
  • Set-CMComplianceRuleExistential параметр -ExpectedValue не позволяет задать отрицательное число, без параметра select [-Existence Выполняется].

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

  • Изменена функция WarnIgnoredParameter, чтобы убедиться, что она будет вызывать IsBoundParameterUsed с параметром silent='true', чтобы избежать блокирующей ошибки, когда дочерний командлет переопределяет базовый параметр как недоступный параметр.
  • Перемещена проверка ожидаемого результата в общее место.

Set-CMDiscoveryMethod

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

  • Set-CMDiscoveryMethod не имеет параметра для настройки учетной записи обнаружения.

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

  • Добавлен новый параметр -UserName для указания учетной записи обнаружения для нового добавления ADContainer для обнаружения системы ИЛИ пользователя AD.

Set-CMDistributionPoint

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

  • Добавлен параметр -EnableLedbat для включения или отключения LEDBAT в DP

Set-CMDriver

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

  • Set-CMDriver —SupportedPlatformName завершится сбоем для массивов

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

  • Исправлена проблема со значением массива для параметра SupportPlatformName.
  • Добавлены новые параметры для SupportedPlatform: -AddSupportedPlatformName; -RemoveSupportedPlatformName; -ClearSupportedPlatform

Прекращение поддержки

  • Нерекомендуемый параметр: -SupportedPlatformName

Set-CMManagementPoint

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

  • Изменена проверка параметров в соответствии с пользовательским интерфейсом, добавлен код для сброса типа подключения клиента при включении или отключении облачного шлюза. Это критическое изменение, так как мы заблокируем включение облачного шлюза (-EnableCloudGateway) без SSL.

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

  • Set-CMManagementPoint -EnableCloudGateway, сначала задайте значение MP как HTTPS/EnableCloudGateway true, а затем задайте для параметра MP значение HTTP, чтобы параметр EnableCloudGateway не проверял.

Set-CMStatusFilterRule

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

  • Set-CMStatusFilterRule не работает с заданием идентификатора пакета

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

  • Разрешить пользователю снова задавать свойство без указания источника. Отличие в пользовательском интерфейсе заключается в том, что пользователь должен указывать -PropertyID и -PropertyValue вместе.
  • Добавлен код, чтобы избежать пустого предупреждающего сообщения, если объект не существует.

Set-CMTSStepRunPowerShellScript

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

  • Новые параметры, добавленные для сопоставления изменений, внесенных в шаг запуска скрипта Power Shell в пользовательском интерфейсе редактора последовательности задач:
    • -SourceCode
    • -Workingdirectory
    • -OutputVariableName
    • -Времени ожидания
    • -Пользователя
    • -Пароль
    • -SuccessCodes

Set-CMWindowsFirewallPolicy

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

  • Set/Remove-CMWindowsFirewallPolicy -InputObject необходимо ввести правильный тип из New-CMWindowsFirewallPolicy.

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

  • Исправлена проверка типа.