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

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

  • Статья

Область действия: Configuration Manager (Current Branch)

Примечание

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

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

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

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

  • New-CMGlobalConditionExpression
  • New-CMRegistryAccessControlEntry
  • New-CMRequirementRuleActiveDirectorySiteValue
  • New-CMRequirementRuleBooleanValue
  • New-CMRequirementRuleCMSiteValue
  • New-CMRequirementRuleCommonValue
  • New-CMRequirementRuleDeviceOwnershipValue
  • New-CMRequirementRuleExistential
  • New-CMRequirementruleExpression
  • New-CMRequirementRuleFileAttributeValue
  • New-CMRequirementRuleFilePermissionValue
  • New-CMRequirementRuleFreeDiskSpaceValue
  • New-CMRequirementRuleInputTypeValue
  • New-CMRequirementRuleOperatingSystemLanguageValue
  • New-CMRequirementRuleOperatingSystemValue
  • New-CMRequirementRuleOUValue
  • New-CMRequirementRuleScreenResolutionValue

Поддерживаемые командлеты add и Set-CM*DeploymentType добавили параметры для GroupDetectionClauses и DetectionClauseConnector.

Примеры

Создание простого выражения с правилом
$rule1 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 2048 -RuleOperator GreaterEquals
$myRuleExpression = New-CMRequirementRuleExpression -AddRequirementRule $rule1
$myGC = New-CMGlobalConditionExpression -Name "GCExp" -DeviceType Windows -RootExpression $myRuleExpression
Добавление сложного выражения глобального условия
$ruleProc = Get-CMGlobalCondition -Name "Number of processors" | New-CMRequirementRuleCommonValue -Value1 2 -RuleOperator GreaterEquals
$ruleMem1 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 2048 -RuleOperator GreaterThan
$ruleMem2 = Get-CMGlobalCondition -Name "Total physical memory" | New-CMRequirementRuleCommonValue -Value1 4096 -RuleOperator LessEquals
$ruleCPUSpeed1 = Get-CMGlobalCondition -Name "CPU Speed" | New-CMRequirementRuleCommonValue -Value1 5120 -RuleOperator LessEquals
$ruleCPUSpeed2 = Get-CMGlobalCondition -Name "CPU Speed" | New-CMRequirementRuleCommonValue -Value1 1024 -RuleOperator GreaterThan
$expressionProc = New-CMRequirementRuleExpression -AddRequirementRule $ruleProc
$expressionMem = New-CMRequirementRuleExpression -AddRequirementRule $ruleMem1, $ruleMem2 -ClauseOperator And
$expressionCPU = New-CMRequirementRuleExpression -AddRequirementRule $ruleCPUSpeed1, $ruleCPUSpeed2 -ClauseOperator And
$myRuleExpression = New-CMRequirementRuleExpression -RootExpression $expressionProc -AddExpression $expressionMem,$expressionCPU -ClauseOperator And -AddAsGroup -GroupOperator Or
$myGC = New-CMGlobalConditionExpression -Name "GCExp" -DeviceType Windows -RootExpression $myRuleExpression
Добавление правила языка
$myGC = Get-CMGlobalCondition -Name "Operating System Language" | Where-Object PlatformType -eq 1
$cultureA = [System.Globalization.CultureInfo]::GetCultures([System.Globalization.CultureTypes]::AllCultures) | Where-Object Name -eq "zh"
$cultureB = [System.Globalization.CultureInfo]::GetCultures([System.Globalization.CultureTypes]::AllCultures) | Where-Object Name -eq "zh-CN"
$myRule = $myGC | New-CMRequirementRuleOperatingSystemLanguageValue -RuleOperator NoneOf -Culture $cultureA,$cultureB -IsMobile $False
Set-CMScriptDeploymentType -ApplicationName "myApp" -DeploymentTypeName "myDT" -AddRequirement $myRule
Создайте простое выражение с правилом.
$clauseFile1 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 1024 -ExpressionOperator IsEquals -Value
$clauseFile2 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 2048 -ExpressionOperator IsEquals -Value
$clauseFile3 = New-CMDetectionClauseFile -FileName "abc" -Path "c:\abc" -PropertyType Size -ExpectedValue 4096 -ExpressionOperator IsEquals -Value

Set-CMScriptDeploymentType -ApplicationName "testApp1" -DeploymentTypeName "abc" -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3 -DetectionClauseConnector @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"} -GroupDetectionClauses $clauseFile2.Setting.LogicalName, $clauseFile3.Setting.LogicalName

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

Нет

Нерекомендуемые командлеты

Нет

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

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

Get-CMAadConditionalAccessPolicy и Set-CMAadConditionalAccessPolicy

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

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

  • Нет

Import-CMSecurityRole

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

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

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

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-CMDistributionPoint

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

  • Новый параметр EnableLedbat для включения LEDBAT для точки распространения

Add-CMIntuneSubscription

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

  • Не удается задать для CompanyLogoPath или CompanyLogoThemedPath изображение размером более 400 x 100 и 750 КБ

Add-CMManagementPoint

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

  • Если параметр EnableCloudGateway имеет значение $true, параметр CommunicationType может задавать неподдерживаемое значение Http

Clear-CMPxeDeployment

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

  • Командлет не очищает развертывания PXE

Get-CMDevice

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

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

Get-CMHierarchySetting

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

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

New-CMAntimalwarePolicyDeployment

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

  • Командлет позволяет указать коллекцию пользователей в качестве целевого объекта развертывания.

New-CMComplianceRuleExistential

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

  • Параметр ExpectedValue теперь допускает отрицательные числа

New-CMConfigurationPolicyuDeployment

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

  • Параметр PostponeDateTime недоступен во всех наборах параметров

New-CMUserDataAndProfileConfigurationItem

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

  • Не удается использовать с параметром $false DetectSlowLinkDisabled
  • Некоторые параметры не могут быть задано, если detectSlowLink имеет значение $true

New-CMWirelessProfile

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

  • Теперь можно использовать "Быстрый" с параметром EapType
  • Новый параметр RememberUserCredentials можно использовать для задания или очистки учетных данных.

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

  • Параметр RememberCredentials заменен функцией RememberUserCredentials

Set-CMComplianceRuleExistential

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

  • Параметр ExpectedValue теперь допускает отрицательные числа

Set-CMDistributionPoint

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

  • Новый параметр EnableLedbat для настройки LEDBAT для точки распространения

Set-CMHierarchySetting

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

  • Новый параметр TelemetryLevel для настройки параметров данных об использовании

Set-CMIntuneSubscription

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

  • Не удается задать для CompanyLogoPath или CompanyLogoThemedPath изображение размером более 400x100 и 750 КБ

Set-CMManagementPoint

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

  • Если параметр EnableCloudGateway имеет значение $true, параметр CommunicationType может задавать неподдерживаемое значение Http

Set-CMMsiDeploymentType

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

  • Параметр AddDetectionClause очищает ранее существующее предложение обнаружения кода продукта MSI
  • Сбой параметра AddRequirement с "SQL_ERROR"

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

  • Новые параметры GroupDetectionClauses и DetectionClauseConnector для предложений обнаружения группирования

Set-CMSoftwareUpdatePointComponent

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

  • Добавлены новые параметры для настройки замены компонентов и других компонентов.
  • Новый параметр ImmediatelyExpireSupersedenceForFeature для немедленного истечения срока действия замененных обновлений
  • Новый параметр WaitForMonthFeature для настройки срока действия заменяемых обновлений

Set-CMTSStepJoinDomainWorkgroup

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

  • Параметр UserName не поддерживает формат %VARIABLE%

Set-CMTSStepCaptureUserState

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

  • Теперь командлет выдает предупреждение, если используется AddConfigFile , а ModeOption — Standard

Set-CMUserDataAndProfileConfigurationItem

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

  • Теперь командлет выдает предупреждение, если параметры SlowLink и SyncMins используются, когда EnableSlowLink имеет значение $false

Set-CMWirelessProfile

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

  • Теперь можно использовать "Быстрый" с параметром EapType
  • Новый параметр RememberUserCredentials можно использовать для задания или очистки учетных данных.

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

  • Параметр RememberCredentials заменен функцией RememberUserCredentials

Start-CMAntimalwarePolicyDeployment

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

  • Командлет позволяет указать коллекцию пользователей в качестве целевого объекта развертывания.