Configuration Manager版本 2103 的 cmdlet 库更改

适用于: Configuration Manager(current branch)

这些发行说明汇总了版本 2103 中对 Configuration Manager cmdlet 库的更改。

注意

Configuration Manager当前分支版本 2010 是这些更改的基线。 有关详细信息,请参阅版本 2010 Configuration Manager cmdlet 库更改

可更新 PowerShell 帮助的已知问题

从版本 2010 开始,可以使用 Update-Help cmdlet 下载 Configuration Manager PowerShell 模块的最新信息。

在版本 2103 中,PowerShell 模块结构从 29 个 DLL 更改为 2 个。 PowerShell XML 帮助文件与 cmdlet 的 DLL 相关联。 因此,版本 2010 帮助内容与版本 2103 主机不兼容,版本 2103 帮助内容与版本 2010 主机不兼容。

由于版本 2103 的可更新内容的结构和发布方式发生了此更改,因此不要在版本 2010 站点上使用 Update-Help 。 将站点更新到版本 2103,然后更新本地帮助内容。

cmdlet 将在版本 2010 主机上成功下载内容,但 Get-Help 将仅返回默认使用情况信息。 此行为是因为 PowerShell 无法在正确的 XML 文件中找到 cmdlet 信息,而现在该文件已有所不同。 在版本 2103 发布之前,如果对版本 2010 站点使用 Update-Help ,则可以立即继续使用 Get-Help

同样,如果在版本 2010 站点上使用 Update-Help ,请在更新到版本 2103 后再次运行 Update-Help 以获取帮助内容的兼容版本。 否则 ,Get-Help 将仅返回默认使用情况信息。

注意

此问题对于版本 2010 是唯一的。 由于结构发生了更改,因此对于更高版本来说,这应该不会成为问题。

PowerShell 模块

如果设备上的Configuration Manager控制台尚未连接到站点,如果手动导入 ConfigurationManager 模块,它将基于默认 SMS 提供程序为站点创建 PowerShell 驱动器。

从版本 2103 开始,ConfigurationManager PowerShell 模块需要Microsoft .NET 版本 4.7.2 或更高版本。

不支持 PowerShell 版本 7 的 Cmdlet

虽然Configuration Manager cmdlet 为 PowerShell 版本 7 提供常规支持,但以下 cmdlet 不支持 PowerShell 7:

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

它们需要.NET Framework而不是与 PowerShell 版本 7 一起使用的 .NET Core。

从版本 2103 开始,如果尝试在 PowerShell 版本 7 会话中使用这些 cmdlet,它们将失败并出现以下错误: This cmdlet only supports the ".NET Framework" runtime.

New cmdlet

Cmdlet 更改

已对此版本中的现有 cmdlet 进行了以下更改。 更改可能是新功能、bug 修复或弃用。 某些更改可能会中断。 如果使用本节中列出的某个 cmdlet 或功能区域,请仔细查看更改,以了解它们如何影响你的使用。

快速支持

以下 cmdlet 现在支持 Fast 参数。 使用此参数不自动刷新延迟属性。 延迟属性包含检索效率相对较低的值。 获取这些属性可能会导致更多的网络流量并影响 cmdlet 性能。

  • 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_DCMDeploymentErrorStatusSMS_DCMDeploymentNonCompliantStatusSMS_DCMDeploymentCompliantStatus等类型的输入对象类型验证问题。
  • 通过将输出对象类型 SMS_AppDeploymentRequirementsNotMetStatus 更改为 SMS_AppDeploymentRequirementsNotMetAssetDetails,修复了输出无效类类型问题。
  • 将输出对象类型从 SMS_AppDeploymentAssetDetails 更改为 SMS_AppDeploymentErrorAssetDetails 以获取更多错误详细信息。
  • SMS_UpdateDeploymentSummary添加了输入对象类型,以便此 cmdlet 可以获取更新部署详细信息。 将 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

已修复的 Bug

修复了安装使用时间格式“yyyy/MM/dd”创建的应用时的软件中心显示问题。

New-CMCertificateProfileScep

已修复的 Bug

修复了参数 SanType 的问题。

New-CMCollection

非中断性变更

修复了 使用 Name 参数与控制台保持一致的验证。

New-CMOperatingSystemImage

非中断性变更

添加了参数 Index。 添加此参数时,站点将从多索引图像中提取单个索引图像。 然后,它将新图像放置在与原始图像相同的源文件夹中。

New-CMOperatingSystemInstaller

非中断性变更

添加了参数 Index。 添加此参数时,站点会将当前多索引图像替换为新的单索引图像。

New-CMTSRule

非中断性变更

参数 引用VariableOperator 具有另一个可能的值: NotLike

New-CMTSStepConditionVariable

非中断性变更

Parameter OperatorType 具有另一个可能的值: NotLike

New-CMSoftwareUpdateAutoDeploymentRule

中断性变更

修复了参数 O365LanguageSelection 的问题。 现在需要指定具有国家/地区名称的语言。 此更改使此参数与 Configuration Manager 控制台中的选项保持一致。 例如,-O365LanguageSelection "English (美国)"

Set-CMCertificateProfileScep

已修复的 Bug

修复了参数 SanType 的问题。

Set-CMClientPushInstallation

非中断性变更

添加参数 AllownNTLMFallback 以启用 NTLM 回退。

Set-CMCollection

非中断性变更

修复了 使用 NewName 参数与控制台保持一致的验证。

Set-CMEmailProfile

非中断性变更

  • 修复了 将 NewName 参数指定 sAMAccountName 为帐户用户名时出现的问题。
  • 修复了解析 DomainName 时的参数问题。

Set-CMFallbackStatusPoint

非中断性变更

修复了不一致的参数名称。

Set-CMThirdPartyUpdateCatalog

非中断性变更

添加参数 CategoryNamePublishOptionCategoryIdPublishOption。 订阅 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 个其他类似 cmdlet。

非中断性变更

Parameter OperatorType 具有另一个可能的值: NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

中断性变更

修复了参数 O365LanguageSelection 的问题。 现在需要指定具有国家/地区名称的语言。 此更改使此参数与 Configuration Manager 控制台中的选项保持一致。 例如,-O365LanguageSelection "English (美国)"

如何提供反馈或报告问题

本文中所述的许多修复和改进都是你的反馈的结果。

若要发送反馈,请使用 Configuration Manager 控制台。 有关详细信息,请参阅 PowerShell 的反馈