版本2103的 Configuration Manager cmdlet 库更改
适用范围: Configuration Manager (Current Branch)
这些发行说明汇总了2103版中 Configuration Manager cmdlet 库的更改。
备注
当前分支版本 2010 Configuration Manager 是这些更改的基线。 有关详细信息,请参阅 版本2010的 Configuration Manager cmdlet 库更改。
可更新的 PowerShell 帮助的已知问题
从版本 2010 开始,可以使用 Update-Help cmdlet 下载 Configuration Manager PowerShell 模块的最新信息。
在版本2103中,PowerShell 模块结构从29个 Dll 更改为两个。 PowerShell XML 帮助文件与 cmdlet 的 DLL 关联。 因此版本2010帮助内容与版本2103控制台不兼容,版本2103帮助内容与版本2010控制台不兼容。
由于在版本2103的版本中对可更新内容进行结构化和发布的方式进行了更改,因此请勿在版本2010站点上使用 update-help 。 将站点更新到版本 2103,然后更新本地帮助内容。
在版本 2010 控制台上,该 cmdlet 会成功下载内容,但 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
它们需要 PowerShell 版本 7 中使用的 .NET Framework 而不是 .NET Core。
从版本2103开始,如果你尝试在 PowerShell 版本7会话中使用这些 cmdlet,它们会失败,并出现以下错误: This cmdlet only supports the ".NET Framework" runtime.
新 cmdlet
- CMApplicationGroup:使用此 cmdlet 获取应用程序组。
- CMDuplicateHardwareIdGuid:按 GUID 获取重复的硬件标识符。
- CMDuplicateHardwareIdMacAddress:按 MAC 地址获取重复的硬件标识符。
- CMApplicationGroup:使用此 cmdlet 可创建新的应用程序组。
- CMThirdPartySoftwareUpdateContent:使用此 cmdlet 发布第三方更新内容。
- CMApplicationGroup:使用此 cmdlet 删除特定的应用程序组。
- CMClientSettingDeployment:使用此 cmdlet 可以删除客户端设置的特定部署。
- CMApplicationGroup:使用此 cmdlet 配置特定的应用程序组。
- CMCISupportedPlatform:使用此 cmdlet 为配置项目配置平台。
- CMCloudManagementGateway:将云管理网关 (CMG) 的配置同步到 Azure。
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_DCMDeploymentErrorStatus、SMS_DCMDeploymentNonCompliantStatus 和 SMS_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
非重大变化
参数 ReferencedVariableOperator 有另一个可能的值: NotLike
。
New-CMTSStepConditionVariable
非重大变化
参数 OperatorType 有另一个可能的值: NotLike
New-CMSoftwareUpdateAutoDeploymentRule
重大更改
修复了参数 O365LanguageSelection 的问题。 你现在需要为国家/地区名称指定一种语言。 此更改将此参数与 Configuration Manager 控制台中的选项保持一致。 例如: -O365LanguageSelection "English (United States)"
Set-CMCertificateProfileScep
已修复的 Bug
修复了参数 SanType 的问题。
Set-CMClientPushInstallation
非重大变化
添加参数 AllownNTLMFallback 以启用 NTLM 回退。
Set-CMCollection
非重大变化
修复了使用 NewName 参数进行验证以与控制台保持一致的问题。
Set-CMEmailProfile
非重大变化
- 修复了将
sAMAccountName
指定为帐户用户名时的 NewName 参数问题。 - 修复了解析 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 其他类似 cmdlet。
非重大变化
参数 OperatorType 有另一个可能的值: NotLike
Set-CMSoftwareUpdateAutoDeploymentRule
重大更改
修复了参数 O365LanguageSelection 的问题。 你现在需要为国家/地区名称指定一种语言。 此更改将此参数与 Configuration Manager 控制台中的选项保持一致。 例如: -O365LanguageSelection "English (United States)"
如何提供反馈或报告问题
本文中所述的许多修补程序和改进都是您的反馈结果。
若要发送反馈,请使用 Configuration Manager 控制台。 有关详细信息,请参阅 PowerShell 反馈。
若要提交新的功能请求,请参阅 UserVoice 上 Configuration Manager的 PowerShell 组。