Configuration Manager版本 1910 的 Cmdlet 库更改

适用于: Configuration Manager(current branch)

备注

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

重要更改

New cmdlet

New-CMDuplicateHardwareIdGuid

使用此 cmdlet 按 GUID 添加重复的硬件标识符。

New-CMDuplicateHardwareIdGuid -Id 24D0F753-B2E2-4D9C-B07C-099C4FC1EF3C

New-CMDuplicateHardwareIdMacAddress

使用此 cmdlet 按 MAC 地址添加重复的硬件标识符。

New-CMDuplicateHardwareIdMacAddress -MacAddress 01:02:03:04:05:E0

New-CMThirdPartyUpdateCatalog

使用此 cmdlet 创建新的第三方更新目录。

New-CMThirdPartyUpdateCatalog -DownloadUrl $downloadUrl -PublisherName $publisher -Name $name -Description $description -SupportUrl $supportUrl -SupportContact $supportContact

Get-CMThirdPartyUpdateCatalog

使用此 cmdlet 获取第三方更新目录。

Get-CMThirdPartyUpdateCatalog
Get-CMThirdPartyUpdateCatalog -Id $id
Get-CMThirdPartyUpdateCatalog -Name $name
Get-CMThirdPartyUpdateCatalog -SiteCode $siteCode
Get-CMThirdPartyUpdateCatalog -IsSyncEnabled $true
Get-CMThirdPartyUpdateCatalog -IsCustomCatalog $true

Set-CMThirdPartyUpdateCatalog

使用此 cmdlet 修改第三方更新目录。

Set-CMThirdPartyUpdateCatalog -Name $name -NewName $newName
Set-CMThirdPartyUpdateCatalog -ThirdPartyUpdateCatalog $catalog -Description $newdescription
$catalog | Set-CMThirdPartyUpdateCatalog -SupportContact $newSupportContact -SupportUrl $newSupportUrl

Remove-CMDuplicateHardwareIdGuid

使用此 cmdlet 可按 GUID 删除重复的硬件标识符。

Remove-CMDuplicateHardwareIdGuid -Id 24D0F753-B2E2-4D9C-B07C-099C4FC1EF3C
Remove-CMDuplicateHardwareIdGuid -InputObject $myGuid #(<IResultObject#SMS_CommonSmbiosGuids>)

Remove-CMDuplicateHardwareIdMacAddress

使用此 cmdlet 可按 MAC 地址删除重复的硬件标识符。

Remove-CMDuplicateHardwareIdMacAddress -MacAddress 01:02:03:04:05:E0
Remove-CMDuplicateHardwareIdMacAddress -InputObject $myMacAddress #(<IResultObject#SMS_CommonMacAddresses>)

Remove-CMThirdPartyUpdateCatalog

使用此 cmdlet 删除第三方更新目录。

Remove-CMThirdPartyUpdateCatalog -Id $catalog.ID -Force
Remove-CMThirdPartyUpdateCatalog -Name $catalog.Name -Force
Remove-CMThirdPartyUpdateCatalog -ThirdPartyUpdateCatalog $catalog -Force
$catalog | Remove-CMThirdPartyUpdateCatalog -Force

删除了 cmdlet

将使用混合服务的末尾删除以下 cmdlet:

  • Add-CMIntuneSubscription

  • Add-CMMdmEnrollmentManager (Add-CMIntuneDeviceEnrollmentManager)

  • Export-CMWindowsEnrollmentProfile

  • Get-CMConditionalAccessPolicy (Get-CMOnPremConditionalAccessPolicy)

  • Get-CMCorpOwnedDevice

  • Get-CMDeviceActionState (Get-CMDeviceAction)

  • Get-CMIntuneSubscription

  • Get-CMIosEnrollmentProfile

  • Get-CMMdmEnrollmentManager (Get-CMIntuneDeviceEnrollmentManager)

  • Get-CMWindowsEnrollmentProfile

  • Get-CMWindowsEnrollmentProfilePackage

  • Invoke-CMDeviceAction

  • New-CMApnsCertificateRequest

  • New-CMConditionalAccessPolicy (New-CMOnPremConditionalAccessPolicy)

  • New-CMDepTokenRequest

  • New-CMIosEnrollmentProfile

  • New-CMWindowsEnrollmentProfile

  • Remove-CMConditionalAccessPolicy (Remove-CMOnPremConditionalAccessPolicy)

  • Remove-CMCorpOwnedDevice

  • Remove-CMIntuneSubscription

  • Remove-CMIosEnrollmentProfile

  • Remove-CMMdmEnrollmentManager (Remove-CMIntuneDeviceEnrollmentManager)

  • Remove-CMWindowsEnrollmentProfile

  • Remove-CMWindowsEnrollmentProfilePackage

  • Set-CMConditionalAccessPolicy (Set-CMOnPremConditionalAccessPolicy)

  • Set-CMIntuneSubscription

  • Set-CMIntuneSubscriptionAndroidProperty (Set-CMIntuneSubscriptionAndroidProperties)

  • Set-CMIntuneSubscriptionAppleDepProperty

  • Set-CMIntuneSubscriptionAppleProperty

    (别名:)

    • Set-CMIntuneSubscriptionMacOSProperties
    • Set-CMIntuneSubscriptionIosProperties
    • Set-CMIntuneSubscriptionMacOSProperty
    • Set-CMIntuneSubscriptionIosProperty
    • Set-CMIntuneSubscriptionAppleMdmProperty
  • Set-CMIntuneSubscriptionPassportForWorkProperty

  • Set-CMIntuneSubscriptionWindowsPhoneProperty (Set-CMIntuneSubscriptionWindowsPhoneProperties)

  • Set-CMIntuneSubscriptionWindowsProperty (Set-CMIntuneSubscriptionWindowsProperties)

  • Set-CMIosEnrollmentProfile

  • Set-CMIosEnrollmentProfileAssignment

  • Set-CMWindowsEnrollmentProfile

已弃用的 cmdlet

已知问题

以下项目是未在此版本中解决的 Cmdlet 库的已知问题。

Import-CMSecurityRole

Cmdlet 可能会失败,但查找文件 SecuredRoles.xsd时出现 DirectoryNotFoundException 错误。

解决方法

  • 针对ConfigurationManager.psd1文件而不是逻辑路径或模块名称调用Import-Module

Set-CMSoftwareUpdatePoint

即使基础 SMS 提供程序对象已更改,Configuration Manager控制台中也可能不会显示对计划所做的更改。

解决方法

  • 退出并重新启动Configuration Manager控制台。

资源跟踪和恢复 (beta)

此版本添加了新的 cmdlet,以支持跟踪 PowerShell 运行时使用的 SMS 提供程序对象,并在不再需要这些资源时清理这些资源。

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

运行 Start-CMObjectTracking时,PowerShell 运行时会跟踪 IResultObject Cmdlet 库 cmdlet 创建的对象。 对于未手动清理 .Dispose()的 cmdlet,请对单个对象使用 Disconnect-CMTrackedObject 回收它们。

示例

# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject

# Reclaim all tracked objects
Disconnect-CMTrackedObject -All

回收对象后,无法再通过对象管道重用或传递给另一个 cmdlet。

Stop-CMObjectTracking 可用于关闭对象跟踪。 以前分配的对象保持活动状态。

无人认领资源可能导致 SMS 提供程序引发配额冲突错误。 这些配额问题通常表现在使用大型 SMS 提供程序对象集或长时间运行的环境中。

备注

此功能是实验性的,可能会在将来的版本中进行更改或删除。 它是选择加入的,默认情况下未启用。

Cmdlet 更改

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

Add-CMDistributionPoint

非中断性更改

现在,cmdlet 支持通过 -Force 交换机使用重复的证书:

Add-CMMsiDeploymentType

已修复的 Bug

修复了卸载内容位置的验证问题。

Import-CMDriver

已修复的 Bug

  • 修复了使用 txtsetup.oem 的驱动程序的问题。
  • 修复了目标驱动程序包以前从未分发过的问题。

New-CMApplicationDeployment

已修复的 Bug

修复了错误的处置问题。

New-CMDriverPackage

非中断性更改

为制造商和模型添加了新参数。 可以使用它们来管理驱动程序目录和任务序列预缓存。

  • -DriverManufacturer [string]
  • -DriverModel [string]
示例
Get-CMDriverPackage | Set-CMDriverPackage -DriverManufacturer "Microsoft" -DriverModel "Surface 2"
Set-CMDriverPackage -PackageId MCS00091 -DriverManufacturer "Microsoft" -DriverModel "Surface 2"
Get-CMDriverPackage | Where-Object {$_.Name -like "Surface Book 2"} | Set-CMDriverPackage -DriverManufacturer "Microsoft" -DriverModel "Surface 2"
New-CMDriverPackage -Name "Surface Book 2 Drivers" -Description "Some descriptive text" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

New-CMSoftwareUpdateAutoDeploymentRule

非中断性更改

该 cmdlet 现在在创建规则时支持 “无部署包 ”选项。

示例
New-CMSoftwareUpdateAutoDeploymentRule -Collection $collection -Name $name -Architecture X86, Itanium, X64

New-CMTaskSequence

非中断性更改

此 cmdlet 有一个新的参数来支持任务序列中的高性能选项:

-HighPerformance [bool]

New-CMTSStepApplyWindowsSetting

非中断性更改

此 cmdlet 包含新的参数,用于支持任务序列步骤中的新区域设置设置:

  • -InputLocale [string]
  • -SystemLocale [string]
  • -UserLocale [string]
  • -UILanguage [string]
  • -UILanguageFallback [string]
示例

若要将输入区域设置为俄罗斯 (俄罗斯) ,请指定字符串 ru-ru-InputLocale "ru-ru"

New-CMTSStepDownloadPackageContent

已修复的 Bug

修复了用于添加包的重复包检查问题。

New-CMTSStepRunCommandLine

非中断性更改

添加了一个新参数以支持输出变量选项: -OutputVariableName [string]

Get-CMDevice

已修复的 Bug

修复了集合中没有访问权限的设备查询问题。

Get-CMScript

已修复的 Bug

修复了通配符支持问题。

Remove-CMApplicationDeployment

已修复的 Bug

修复了错误的处置问题。

Remove-CMDevice

已修复的 Bug

修复了设备查询问题。

Set-CMBootImage

非中断性更改

添加了一个新参数以支持键盘布局设置: -InputLocale [string]

Set-CMClientSettingClientPolicy

非中断性更改

添加了一个新参数,用于支持具有多个用户会话的设备上用户策略的客户端设置: -EnableUserPolicyOnTS [bool]

Set-CMClientSettingSoftwareUpdate

非中断性更改

添加了新的参数以支持第三方更新: -EnableThirdPartyUpdates [bool]

示例
Set-CMClientSettingSoftwareUpdate -Name $clientDeviceSettingName -Enable $true -EnableThirdPartyUpdates $true
Set-CMClientSettingSoftwareUpdate -DefaultSetting -Enable $true -EnableThirdPartyUpdates $true

Set-CMDistributionPoint

已修复的 Bug

  • 修复了重新分配站点代码的问题。
  • 修复了设备查询问题。

非中断性更改

该 cmdlet 现在支持通过交换机使用重复的证书 -Force

Set-CMDriverPackage

非中断性更改

添加了新参数以支持制造商和模型设置:

  • -DriverManufacturer [string]
  • -DriverModel [string]

Set-CMMsiDeploymentType

已修复的 Bug

修复了卸载内容位置的验证问题。

Set-CMScript

已修复的 Bug

  • 修复了脚本文本值问题。
  • 修复了通配符支持问题。

Set-CMSite

已修复的 Bug

  • 修复了脚本文本值问题。
  • 修复了通配符支持问题。

Set-CMSiteSystemServer

非中断性更改

修复了与代理相关的属性设置问题。

Set-CMSoftwareUpdateAutoDeploymentRule

非中断性更改

添加了新参数,允许用户为现有软件更新自动部署规则设置部署包。

  • -DeploymentPackageName [string]
  • -DeploymentPackage [IResultObject]
示例
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $packageName
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $package

Set-CMSoftwareUpdateDeployment

已修复的 Bug

修复了用于和 -GenerateOperationsManagerAlert. 的-DisableOperationsManagerAlert属性设置问题。

Set-CMSoftwareUpdateDeploymentPackage

非中断性更改

添加了强制开关以强制删除过期的 NAP 更新: -Force [switch]

Set-CMSoftwareUpdatePointComponent

非中断性更改

  • 添加了支持第三方更新选项的新参数:

    • -EnableThirdPartyUpdates [bool]
    • -EnableManualCertManagement [bool]
  • 添加了新参数以支持功能更新运行时选项:

    • -NonFeatureUpdateMaxRuntimeMins [int]
    • -FeatureUpdateMaxRuntimeMins [int]
示例
Set-CMSoftwareUpdatePointComponent -SiteCode $Site.SiteCode -EnableThirdPartyUpdates $true
Set-CMSoftwareUpdatePointComponent -SiteCode $Site.SiteCode -EnableManualCertManagement $true

Set-CMTaskSequence

非中断性更改

添加了一个新参数以支持任务序列中的高性能选项: -HighPerformance [bool]

Set-CMTSStepApplyWindowsSetting

非中断性更改

添加了新参数以支持此任务序列步骤中的区域设置:

  • -InputLocale [string]
  • -SystemLocale [string]
  • -UserLocale [string]
  • -UILanguage [string]
  • -UILanguageFallback [string]
示例

若要将输入区域设置为俄罗斯 (俄罗斯) ,请指定字符串 ru-ru-InputLocale "ru-ru"

Set-CMTSStepDownloadPackageContent

已修复的 Bug

  • 修复了用于添加包的重复包检查问题。
  • 修复了添加/删除包的验证问题

Set-CMTSStepRunCommandLine

非中断性更改

支持输出变量选项的新参数: -OutputVariableName [string]