Current Branch 1702 的 Configuration Manager Cmdlet 库更改
注意
System Center Configuration Current Branch 1610 是这些更改的基线。 有关更多详细信息,请参阅 Current Branch 1610 的 Configuration Manager Cmdlet 库更改 。
重要更改
文档库更新
有关最新的 cmdlet 库文档,请参阅 ConfigurationManager 模块参考。
已删除 cmdlet
以下 cmdlet 不再受支持,已删除:
Add-CMNokiaDeploymentType
Add-CMOutOfBandServicePoint
Add-CMSystemHealthValidatorPoint
Clear-CMAmtAuditLog
Disable-CMAmtAuditLog
Enable-CMAmtAuditLog
Enable-CMAutomaticAmtProvisioning
Get-CMAutomaticAmtProvisioningStatus
Get-CMCmdletUpdateCheck
Get-CMOutOfBandManagementComponent
Get-CMOutOfBandServicePoint
Get-CMSystemHealthValidatorPoint
Get-CMSystemHealthValidatorPointComponent
New-CMWiredProfileObject
New-CMWirelessProfileObject
Remove-CMAmtProvisioningData
Remove-CMNokiaDeploymentType
Remove-CMOutOfBandServicePoint
Remove-CMSystemHealthValidatorPoint
Send-CMCmdletUpdateCheck
Set-CMCmdletUpdateCheck
Set-CMNokiaDeploymentType
Set-CMOutOfBandManagementComponent
Set-CMOutOfBandServicePoint
Set-CMSystemHealthValidatorPointComponent
Update-CMAmtProvisioning
支持使用逻辑名称导入 ConfigurationManager 模块
现在支持使用逻辑名称或路径导入 ConfigurationManager 模块。
如果将 C:\Program Files (x86) \Microsoft Configuration Manager\AdminConsole\bin 或等效路径添加到 PSModulePath 变量,则可以使用以下项:
Import-Module ConfigrationManager
否则,可以使用以下内容:
Import-Module 'C:\Program Files (x86)\Microsoft Configuration Manager\AdminConsole\bin\ConfigurationManager'
已知问题
这些是 Cmdlet 库的已知问题,未在此版本中解决。
Get-CMAadConditionalAccessPolicy 和 Set-CMAadConditionalAccessPolicy
这些 cmdlet 需要 64 位 PowerShell 环境。
解决方法
- None
New cmdlet
这些是此版本新添加的 cmdlet,可添加新功能或增强现有 cmdlet 的功能。
iOS 注册配置文件
添加了用于配置 iOS 注册配置文件的新 cmdlet。
Get-CMIosEnrollmentProfile
New-CMIosEnrollmentProfile
Remove-CMIosEnrollmentPRofile
Set-CMIosEnrollmentProfile
云管理网关 cmdlet
添加了用于配置云管理网关站点角色的新 cmdlet。
Add-CMCloudManagementGatewayConnectionPoint
Get-CMCloudManagementGateway
Get-CMCloudManagementGatewayConnectionPoint
New-CMCloudManagementGateway
Remove-CMCloudManagementGateway
Remove-CMCloudManagementGatewayConnectionPoint
Set-CMCloudManagementGateway
Set-CMCloudManagementGatewayConnectionPoint
Start-CMCloudManagementGateway
Stop-CMCloudManagementGateway
数据仓库服务点 cmdlet
添加了用于配置数据仓库服务点站点角色的新 cmdlet。
Add-CMDataWarehouseServicePoint
Get-CMDataWarehouseServicePoint
Remove-CMDataWarehouseServicePoint
Set-CMDataWarehouseServicePoint
部署 cmdlet
已编写了几个新的 cmdlet,并围绕部署和部署监视方案进行了改进。
内容分发状态
Get-CMDistributionStatus 是一个新的 cmdlet,可用于获取任何内容对象的分发状态,例如应用程序、设置或程序包。
获取部署
已创建 Cmdlet 以获取与实际部署关联的对象。
Get-CMApplicationDeployment
Get-CMBaselineDeployment
Get-CMConfigurationPolicyDeployment
Get-CMPackageDeployment
Get-CMSoftwareUpdateDeployment
Get-CMTaskSequenceDeployment
部署创建
已创建用于创建新部署的 Cmdlet。 这些 cmdlet 取代了预先存在的 Start-CM*Deployment cmdlet。
New-CMApplicationDeployment
New-CMBaselineDeployment
New-CMConfigurationPolicyDeployment
New-CMPackageDeployment
New-CMSoftwareUpdateDeployment
New-TaskSequenceDeployment
改进了对象管道支持
Set-CM*Deployment、Remove-CM*Deployment 和 Get-CM*DeploymentStatus 现在完全支持对象管道。
Start-CM<功能>已弃用部署 cmdlet
以下 Start-CM<功能>已弃用部署 cmdlet。 替换 cmdlet 在参数名称上可能有所不同,但应具有相同的功能,在某些情况下会得到改进。
Start-CMApplicationDeployment (替换为 New-CMApplicationDeployment)
Start-CMPackageDeployment (替换为 New-CMPackageDeployment)
Start-CMBaselineDeployment (替换为 New-CMBaselineDeployment)
Start-CMConfigurationPolicyDeployment (替换为 New-CMConfigurationPolicyDeployment)
Start-CMTaskSequenceDeployment (替换为 New-CMTaskSequenceDeployment)
Start-CMSoftwareUpdateDeployment (替换为 New-CMSoftwareUpdateDeployment)
Get-CMResultantSettings
此 cmdlet 将检索集合、设备或用户的结果客户端设置。
操作系统升级包更新
添加了用于创建和修改操作系统升级包更新计划的新 cmdlet。
Clear-CMOperatingSystemUpgradeUpdateSchedule
Get-CMOperatingSystemUpgradeUpdateSchedule
New-CMOperatingSystemUpgradeUpdateSchedule
Remove-CMOperatingSystemUpgradeUpdateSchedule
Remove-CMSoftwareUpdateFromGroup
此 cmdlet 将从软件更新组中删除软件更新。
Cmdlet 更改
已针对此版本的现有 cmdlet 进行了以下更改。 更改可能是新功能、bug 修复或弃用,并且可能会中断。 如果使用本节中列出的某个 cmdlet 或功能区域,请仔细查看更改,以了解它们如何影响你的使用。
其他更改
已修复的 Bug
cmdlet 框架可能无法正确使用某些提供程序类使用的大型SMS_EmbeddedPropertyList对象,从而导致在获取或设置这些值时出现未定义的行为。
反恶意软件策略或客户端设置的某些更改组合可能会导致生成无效策略。 处于此状态时,SMS 提供程序将返回“实例不是有效的客户端代理配置”错误。
用于配置管理点和软件更新点的 Cmdlet 添加了 EnableCloudGateway 参数,以允许这些角色与云管理网关一起使用。
站点维护时段配置
非中断性变更
CMMaintenanceWindow cmdlet 现在支持为站点配置维护时段。 Get-CMSite 的输出可以管道化为 New、Remove 或 Set-CMMaintenanceWindow,以配置站点的维护时段。
Add-CMDeploymentType
中断性变更
已删除对创建 Nokia 部署类型的支持。
Add-CMDeviceAfinityToUser
已修复的 Bug
Cmdlet 可能会意外失败并出现 ObjectNotFound 错误。
Add-CMDistributionPoint
已修复的 Bug
Cmdlet 允许在未启用 HTTPS 时将分发点配置为支持 Internet。
非中断性变更
添加了 AllowProxyTraffic 参数。
以前未使用的 InstallInternetServer 参数现在更改分发点配置。
弃用
已弃用 UseComputerAccount 参数。 若要使用计算机帐户,请将 “用户名” 设置为“$null”。
Add-CMEnrollmentPoint
已修复的 Bug
在创建的对象中缺少配置设置的注册点角色。
Add-CMEnrollmentProxyPoint
非中断性变更
添加了 ServiceHost 参数以允许指定远程注册点。
Add-CMIntuneSubscription
已修复的 Bug
ContactEmail 参数不能设置为 null 或空值。
Add-CMMulticastServicePoint
已修复的 Bug
UserName 不会验证域\用户格式是否正确。
StartUdpPort 和 EndUdpPort 参数不会验证某些错误配置的值。
StartIPAddress 和 EndIPAddress 参数不会验证某些错误配置的值。
非中断性变更
添加了 UseAnyRangeIP 参数。
弃用
不再支持 ClientTransferRate 参数。
Approve-CMUserDeviceAffinityRequest
已修复的 Bug
Cmdlet 允许批准以前处理的相关性请求。
Convert-CMSchedule
已修复的 Bug
InputObject 参数不接受管道计划对象。
Deny-CMUserDeviceAffinityRequest
已修复的 Bug
Cmdlet 允许拒绝以前处理的相关性请求。
Get-CMAlert
已修复的 Bug
无法检索客户端运行状况或终结点保护警报。
Get-CMSiteStatusMessage
非中断性变更
ComputerName、 Severity 和 SiteCode 参数现在接受数组值。
添加了 MessageId、 Module、 Component 和 FilterHashTable 参数,用于进一步筛选。
所有基于字符串的筛选器参数现在都接受通配符。
Get-CMWindowsEnrollmentProfilePackage
已修复的 Bug
不能指定没有参数的 cmdlet。
Import-CMComputerInformation
中断性变更
如果导入已存在的记录并且未指定新的 MergeIfExist 参数,Cmdlet 将失败。
Import-CMDriver
已修复的 Bug
使用 ImportFolder 时,驱动程序包可能会占用比预期更多的空间。
Install-CMClient
非中断性变更
从 Get-CMDevice 和 Get-CMResource 添加了对管道对象的支持。
Invoke-CMRemoteControl
已修复的 Bug
Cmdlet 不接受 来自 Get-CMSiteSystemServer 的管道对象。
如果站点系统服务器不是客户端计算机,则无法将其作为远程控制的目标。
New-CMActiveDirectoryForest
非中断性变更
添加了 UserName 参数以允许配置发现帐户。
添加了 AddPublishingSite 参数。
New-CMApplicationDeployment
非中断性变更
添加了 UpdateSupersedence 参数。
New-CMBoundaryGroup
中断性变更
FastLink 是 AddSiteSystemServer 参数中哈希表唯一受支持的值。 已删除对所有其他值的支持。
New-CMCertificateProfilePfx
已修复的 Bug
KeyStorageProvider 参数值可能不会按预期应用于新创建的证书配置文件。
New-CMGlobalCondition
中断性变更
已删除对创建 Nokia 全局条件的支持。
New-CMProgram
非中断性变更
添加了 AddSupportedOperatingSystemPlatform 参数。
New-CMSoftwareUpdateAutoDeploymentRule
已修复的 Bug
MicrosoftAsVendor 参数值可能不会应用于规则。
非中断性变更
添加了 Vendor 参数以支持第三方修补程序。
添加了 GenerateFailureAlert 参数。
New-CMSoftwareUpdateDeployment
非中断性变更
添加了 RequirePostRebootFullScan 参数。
New-CMStandaloneMedia
非中断性变更
添加了 MediaStartDate 和 MediaExpirationDate 参数,以支持媒体过期。
添加了 Application、 DriverPackage 和 Package 参数,用于添加其他媒体内容。
New-CMStatusMessageQuery
已修复的 Bug
创建的查询可能不会显示在预期的管理员控制台位置。
New-CMWindowsEnrollmentProfile
已修复的 Bug
EnrollmentProxyPoint 参数可以设置为 null 或空值。
SiteCode 参数值可能会导致管理员控制台中出现验证错误。
Remove-CMResource
已修复的 Bug
删除资源不会删除状态迁移关联。
Remove-CMWindowsEnrollmentProfilePackage
已修复的 Bug
运行 cmdlet 时,可能会引发不明确的ParameterSet 错误。
Set-CMActiveDirectoryForest
非中断性变更
添加了 UserName 参数以允许配置发现帐户。
添加了 AddPublishingSite 和 RemovePublishingSite 参数。
Set-CMAdvancedThreatProtectionPolicy
已修复的 Bug
增加或降低优先级可能会导致返回 ObjectNotFound 错误。
Set-CMAntimalwarePolicy
已修复的 Bug
WhatIf 可能不会显示预期的策略名称。
使用管道对象时,无法更改实时保护设置。
非中断性变更
Cmdlet 现在接受来自 Get-CMAntimalwarePolicy 的管道输入。
Set-CMApplication
非中断性变更
添加了 AddSupportContact、 AddOwner、 RemoveSupportContact、 RemoveOwner、 ClearSupportContact 和 ClearOwner 参数,以支持就地修改支持联系人或所有者。
Set-CMAppVVirtualEnvironment
已修复的 Bug
PassThru 不返回最新的对象。
Set-CMBaseline
已修复的 Bug
PassThru 不返回 SMS_ConfigurationItem 对象。
非中断性变更
添加了 ClearRequiredConfigurationItem、 ClearProhibitedConfigurationItem、 ClearOptionalConfigurationItem、 ClearOSConfigurationItem、 ClearSoftwareUpdate、 ClearBaseline、 RemoveRequiredConfigurationItem、 RemoveOptionalConfigurationItem、 RemoveProhibitedConfigurationItemRemoveOSConfigurationItem、 RemoveSoftwareUpdate、 RemoveBaseline、 AddSoftwareUpdate 和 AddBaseline 参数。
Set-CMBoundaryGroup
中断性变更
FastLink 是 AddSiteSystemServer 参数中哈希表唯一受支持的值。 已删除对所有其他值的支持。
Set-CMCertificateProfileTrustedRootCA
已修复的 Bug
使用对象管道可能会导致 ParameterBindingException 错误。
Set-CMClientPushInstallation
非中断性变更
添加了 AddAccount 和 RemoveAccount 参数,以支持客户端推送帐户的就地修改。
Set-CMClientSettingComputerAgent
已修复的 Bug
如果将 EnableHealthAttestation 或 UseOnPremisesHealthAttestation 设置为 true,则不需要 HealthAttestationUrl 参数值。
Set-CMComputerAssociation
非中断性变更
添加了 MigrationId 参数。
Set-CMDeploymentType
中断性变更
已删除对修改 Nokia 部署类型的支持。
Set-CMDiscoveryMethod
已修复的 Bug
PollingSchedule 值可能无法正确应用于发现方法。
Set-CMDistributionPoint
已修复的 Bug
Cmdlet 允许在未启用 HTTPS 时将分发点配置为支持 Internet。
非中断性变更
添加了 AllowProxyTraffic 参数。
以前未使用的 InstallInternetServer 参数现在更改分发点配置。
弃用
已弃用 UseComputerAccount 参数。 若要使用计算机帐户,请将 “用户名” 设置为“$null”。
Set-CMEmailNotificationComponent
非中断性变更
添加了 UseSsl 参数。
Set-CMFileReplicationRoute
已修复的 Bug
FileReplicationAccountName 参数不能设置为 null 或空值。
Set-CMHierarchySetting
非中断性变更
添加了 ExclusionCollection、 ExclusionCollectionId、 ExclusionCollectionName 和 EnableExclusionCollection 参数,用于配置客户端升级排除项。
Set-CMIntuneSubscription
已修复的 Bug
ContactEmail 参数不能设置为 null 或空值。
非中断性变更
MaximumUserDevice 参数现在支持介于 1 和 15 之间的值。
Set-CMIntuneSubscriptionWindowsPhoneProperty
已修复的 Bug
Cmdlet 可能会意外失败并出现 AetCleanupFailure 错误。
Set-CMMaintenanceTask
已修复的 Bug
PassThru 参数不会导致返回对象。
Set-CMMulticastServicePoint
已修复的 Bug
UserName 参数不会验证域\用户格式是否正确的值。
StartUdpPort 和 EndUdpPort 参数不会验证某些错误配置的值。
StartIPAddress 和 EndIPAddress 参数不会验证某些错误配置的值。
非中断性变更
添加了 UseAnyRangeIP 参数。
弃用
不再支持 ClientTransferRate 参数。
Set-CMProgram
非中断性变更
添加了 AddSupportedOperatingSystemPlatform、 RemoveSupportedOperatingSystemPlatform 和 RunOnAnyPlatform 参数。
Set-CMSite
已修复的 Bug
RemoveClientRequestServiceType 可能无法正确删除指定的值。
非中断性变更
添加了 SiteSystemCollectionBehavior、 ThresholdOfSelectCollectionMax、 ThresholdOfSelectCollectionByDefault 和 ThresholdOfSelectCollectionMax 参数,以配置站点的设备集合阈值。
Set-CMSiteSummaryTask
已修复的 Bug
PassThru 参数不会导致返回对象。
Set-CMSoftwareUpdateAutoDeploymentRule
已修复的 Bug
MicrosoftAsVendor 参数值可能不会应用于规则。
非中断性变更
添加了 Vendor 参数以支持第三方修补程序。
添加了 GenerateFailureAlert 参数。
Set-CMSoftwareUpdateDeployment
非中断性变更
添加了 RequirePostRebootFullScan 参数。
Set-CMSoftwareUpdatePointComponent
已修复的 Bug
EnableSynchronization 和 Schedule 参数的使用可能会导致生成不正确的警告,或者计划未按预期进行修改。
Set-CMStatusFilterRule
已修复的 Bug
对 Priority 参数值的更改可能不适用于状态筛选器规则。
Set-CMTaskSequence
弃用
已弃用 UseDefaultText 参数。 若要使用默认文本,请将 CustomText 设置为 $null。
Set-CMWindowsEnrollmentProfile
已修复的 Bug
颁发机构 参数并非在所有参数集中都可用。