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

Configuration Manager изменения библиотеки командлетов для Current Branch 1710

  • Статья

Примечание.

Конфигурация System Center Current Branch 1706 является базовым показателем для этих изменений. Дополнительные сведения см. в статье Изменения библиотеки командлетов Configuration Manager для Current Branch 1706.

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

Обновления библиотеки документации

Последнюю документацию по библиотеке командлетов см. в справочнике по модулю ConfigurationManager.

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

Следующие командлеты больше не поддерживаются и были удалены:

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

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

  • Invoke-CMEndpointProtectionScan и Save-CMEndpointProtectionDefinition заменены Invoke-CMClientAction.

Отключение автоматического создания PSDrive

При загрузке модуля ConfigurationManager.psd1 PowerShell автоматически пытается создать подключение к последнему поставщику SMS, к которому был доступ с помощью консоли Configuration Manager. В некоторых сценариях такое поведение может оказаться нежелательным. Добавлен раздел реестра для каждого пользователя, который может отключить это поведение и требовать создания диска вручную. Чтобы настроить эту настройку, используйте раздел HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell реестра: и задайте значение DisableCMDriveAutoCreate DWORD, равное 1 (автоматическое создание диска отключено) или 0 (поведение по умолчанию). Удаление DisableCMDriveAutoCreate также обеспечивает поведение по умолчанию.

Примечание.

Если автоматическое создание диска отключено, консоль Configuration Manager может сообщить об ошибке при запуске окна PowerShell.

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

Это известные проблемы с библиотекой командлетов, которые не устранены в этом выпуске.

Get-CMAadConditionalAccessPolicy и Set-CMAadConditionalAccessPolicy

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

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

  • Нет

Import-CMSecurityRole

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

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

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

Get-CMSiteUpdateInstallStatus

Командлет может завершиться ошибкой WqlQueryException.

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

  • Используйте Invoke-CMWmiQuery для прямого запроса к классу SMS_CM_UpdatePackTopLevelMonitoring.
Пример
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

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

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

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

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

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

Командлеты связи устройств

Get-CMResultantCollection получает коллекции, связанные с устройством. Get-CMResultantDeployment будет получать развертывания, предназначенные для устройства.

Управление классом инвентаризации клиента

Добавлены новые командлеты для поддержки изменения классов инвентаризации, используемых для инвентаризации клиентов.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

Последовательности задач

Добавлены новые командлеты для поддержки изменения шагов последовательности задач.

  • Команды последовательности задач (поддерживаются команды Get, New, Remove и Set)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

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

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

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

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

Пример

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

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

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

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

Примечание.

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

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

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

Командлеты параметров соответствия и правил

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

Значение RuleDescription может не применяться к правилу. (командлеты, поддерживающие создание или изменение правил)

Не удается задать значение для раздела реестра по умолчанию (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

Можно вызвать исключение NullReferenceException (New-CMComplianceRuleAssembly)

Отсутствует поддержка DataType (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

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

Улучшена обработка ошибок и создание отчетов.

Add/Set-CMDataWarehouseServicePoint

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

DataWarehouseSqlPort поддерживает значение порта от 1 до 65535. Параметр DaysOfWeek теперь поддерживает значение Daily.

Add/Set-CMExchangeServer

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

Значение параметра EmailAddress может не применяться к конфигурации Exchange Server.

Add-CMMsiDeploymentType

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

Параметр ContentLocation является обязательным при использовании обнаружения скриптов. Добавлены новые параметры UninstallContentLocation и UninstallOption .

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

Улучшена проверка параметра ProductCode .

Add-CMScriptDeploymentType

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

Улучшена проверка параметра ProductCode . Добавлены новые параметры UninstallContentLocation и UninstallOption .

Get-CMDeploymentTypeDependencyGroup

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

Командлет теперь поддерживает значение конвейера из Get-CMDeploymentType.

Get-CMSiteStatusMessage

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

Не все сообщения возвращаются при фильтрации с помощью параметра Серьезность .

Invoke-CMClientAction (ранее — Invoke-CMClientNotification)

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

Параметр ActionType , который принимает все типы уведомлений клиента.

Примечание.

RequestScriptExecution в настоящее время не поддерживается.

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

NotificationType был заменен ActionType

Развертывание New-CM*

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

Командлет позволяет объединять параметры CollectionId, CollectionName и Collection , что может привести к неопределенному поведению.

New-CMBootableMedia

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

Не удается создать носитель в качестве SiteBased.

New-CMWirelessProfile

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

Командлет не выполняется в 64-разрядной среде PowerShell.

Командлет может возвращать ошибку при указании значения для параметра ClientCertificate .

Remove-CMCorpOwnedDevice

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

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

Имя устройства не сообщается при использовании WhatIf или Confirm.

Remove-CMStateMigrationPoint

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

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

Save-CMSoftwareUpdate

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

Добавлены параметры RetryCount и RetryDelaySec для повторного скачивания после сбоя.

Set-CMAccessAccount

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

PassThru может не возвращать обновленный объект.

Set-CMAntimalwarePolicy

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

Не удается использовать подстановочные знаки с параметром AddExcludedFilePath .

Не удается настроить FallbackOrder для заданной политики

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

Добавлены новые параметры для управления списками угроз: AddThreat, RemoveThreat и CleanThreat. AddThreat принимает хэш-строку с ключом, который является именем, а значение имеет тип Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.

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

Параметры ThreatName и OverrideAction заменены параметрами AddThreat, RemoveThreat и CleanThreat.

Set-CMClientSettingComputerAgent

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

Параметр HealthAttestationUrl , так как он больше не используется продуктом.

Set-CMClientSettingHardwareInventory

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

Параметры AddInventoryReportClass, CleanInventoryReportClass и RemoveInventoryReportClass поддерживают изменение инвентаризации оборудования, собираемой клиентами.

Set-CMMsiDeploymentType

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

Улучшена проверка параметра ProductCode .

Set-CMScriptDeployment

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

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

Set-CMScriptDeploymentType

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

Улучшена проверка параметра ProductCode .

Set-CMSoftwareUpdatePointComponent

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

Добавлен новый параметр ContentFileOption для настройки поведения загрузки обновлений.

Set-CMSiteMaintenanceTask

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

Улучшенные отчеты об ошибках

Set-CMWirelessProfile

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

Командлет не выполняется в 64-разрядной среде PowerShell.

При использовании конвейера объектов может возникнуть ошибка MismatchedPSTypeName.

ProxyAddress и ProxyPort не проверяют, используя те же правила, что и консоль Configuration Manager.

Указание ProxyAddress без ProxyPort может привести к созданию недопустимой конфигурации.

SecurityAuthentication можно изменить с помощью конфигураций, которые не поддерживают эту функцию.

EapType должен сочетаться с SecurityAuthentication , даже если последний не меняется.

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

Добавлены параметры RootCertificate, ClientCertificate и RememberCredentials .

Улучшены функциональные возможности настройки политики беспроводной связи MSCHAPv2.

Sync-CMSoftwareUpdate

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

Командлет больше не требует указания параметров.

Примечание.

Если параметры не определены, -ForceSync $true подразумевается.