适用于: Configuration Manager(current branch)
这些发行说明汇总了版本 2010 中对 Configuration Manager cmdlet 库的更改。
从版本 2010 开始,Configuration Manager PowerShell cmdlet 库现在提供对 PowerShell 7 的支持。 有关详细信息,请参阅 对 PowerShell 版本 7 的支持。
注意
Configuration Manager当前分支版本 2002 是这些更改的基线。 有关详细信息,请参阅版本 2006 Configuration Manager cmdlet 库更改。
云管理网关
随着越来越多的客户现在管理远程设备,此版本包括云管理网关 (CMG) 的几个新增和改进的 Windows PowerShell cmdlet。 可以使用这些 cmdlet 自动创建、配置和管理 CMG 服务,并Azure Active Directory (Azure AD) 要求。
注意
虽然某些新 cmdlet 可能与其他Azure服务一起使用,但仅使用云管理连接对其进行测试,以支持 CMG。
例如,Azure管理员首先在 Azure Active Directory (Azure AD) 中创建两个必需的应用。 然后编写一个脚本,该脚本使用以下 cmdlet 部署 CMG:
- Import-CMAADServerApplication:在 Configuration Manager 中创建Azure AD 服务器应用定义。
- Import-CMAADClientApplication:在 Configuration Manager 中创建Azure AD 客户端应用定义。
- 使用 Get-CMAADApplication 获取应用对象,然后传递给 New-CMCloudManagementAzureService 以在 Configuration Manager 中创建Azure服务连接。
- New-CMCloudManagementGateway:在 Azure 中创建 CMG 服务。
- Add-CMCloudManagementGatewayConnectionPoint:创建 CMG 连接点站点系统。
适用于 CMG 的新 cmdlet
- Get-CMAADApplication:从站点获取 Azure Active Directory (Azure AD) 应用对象。
- Get-CMAzureService:获取Azure服务。
- Import-CMAADClientApplication:从 Azure AD 导入客户端应用,并为Configuration Manager站点定义它。
- Import-CMAADServerApplication:从 Azure AD 导入 Web/服务器应用,并为Configuration Manager站点定义它。
- New-CMCloudManagementAzureService:在 Configuration Manager 中创建用于云管理的Azure服务。
- Remove-CMAzureService:删除Azure服务。
- Set-CMCloudManagementAzureService:修改 Configuration Manager 中云管理的 Azure 服务设置。
更新了 CMG 的 cmdlet
以下现有 cmdlet 进行了重大改进。 有关详细信息,请参阅以下发行说明:
CMG 的现有 cmdlet
可以继续使用以下现有 CMG cmdlet:
- Add-CMCloudManagementGatewayConnectionPoint
- Get-CMCloudManagementGateway
- Get-CMCloudManagementGatewayConnectionPoint
- New-CMCloudManagementGateway
- Remove-CMCloudManagementGateway
- Remove-CMCloudManagementGatewayConnectionPoint
- Set-CMCloudManagementGateway
- Set-CMCloudManagementGatewayConnectionPoint
- Start-CMCloudManagementGateway
- Stop-CMCloudManagementGateway
New cmdlet
应用管理
- Add-CMCIDetectionMethod:指定客户端检测应用程序的方式。
- Get-CMApplicationGroupDeployment:获取应用程序组的部署。
- New-CMApplicationGroupDeployment:为应用程序组创建部署。
- Remove-CMApplicationGroupDeployment:删除应用程序组的部署。
- Set-CMApplicationGroupDeployment:配置应用程序组的部署。
集合管理
- Get-CMCollectionDependency:获取目标集合的限制集合。
- Get-CMCollectionDependent:获取集合的依赖关系。
- Get-CMCollectionEvaluationStatus:获取集合评估的状态。
- Get-CMCollectionFullEvaluationStatus:获取集合的完整评估状态。
- Get-CMCollectionIncrementalEvaluationStatus:获取集合的增量评估状态。
- Get-CMCollectionInfoFromEvaluationQueue:从评估队列获取集合信息。
- Get-CMCollectionInfoFromFullEvaluationQueue:从完整的评估队列中获取集合信息。
- Get-CMCollectionInfoFromIncrementalEvaluationQueue:从增量评估队列获取集合信息。
- Get-CMCollectionInfoFromManualEvaluationQueue:从手动评估队列获取集合信息。
- Get-CMCollectionInfoFromNewEvaluationQueue:从新的评估队列获取集合信息。
Windows 10版本升级
- New-CMWindows10EditionUpgrade:创建Windows 10版本升级策略。
- Remove-CMWindows10EditionUpgrade:删除Windows 10版本升级策略。
- Set-CMWindows10EditionUpgrade:配置Windows 10版本升级策略。
Microsoft Edge 浏览器配置文件
- Get-CMMicrosoftEdgeBrowserProfiles:获取Microsoft Edge 旧版浏览器配置文件的策略。
- New-CMMicrosoftEdgeBrowserProfiles:创建用于管理Microsoft Edge 旧版浏览器设置的策略。
- Set-CMMicrosoftEdgeBrowserProfiles:为Microsoft Edge 旧版浏览器配置文件配置策略。
OneDrive for Business配置文件
- Get-CMOneDriveBusinessProfile:获取OneDrive for Business配置文件的策略。
- New-CMOneDriveBusinessProfile:创建OneDrive for Business配置文件策略。
- Set-CMOneDriveBusinessProfile:配置OneDrive for Business配置文件策略。
已弃用和已删除的 cmdlet
Configuration Manager混合环境的以下 cmdlet 不再可用:
- Add-CMAndroidDeploymentType
- Add-CMGooglePlayDeploymentType
- Add-CMIosAppStoreDeploymentType
- Add-CMIosDeploymentType
- Set-CMAndroidDeploymentType
- Set-CMGooglePlayDeploymentType
- Set-CMIosAppStoreDeploymentType
- Set-CMIosDeploymentType
有关详细信息,请参阅 混合 MDM 发生了什么情况?
以下 cmdlet 已弃用:
已知问题
无
Cmdlet 更改
已对此版本中的现有 cmdlet 进行了以下更改。 更改可能是新功能、bug 修复或弃用。 某些更改可能会中断。 如果使用本节中列出的某个 cmdlet 或功能区域,请仔细查看更改,以了解它们如何影响你的使用。
Add-CMComplianceSettingRegistryKeyValue
有关详细信息,请参阅 Add-CMComplianceSettingRegistryKeyValue。
非中断性变更
Parameter ExpectedValue 可以接受空值。
Add-CMDistributionPoint
有关详细信息,请参阅 Add-CMDistributionPoint。
已修复的 Bug
修复了分发点创建问题。
Add-CMDeviceCollectionDirectMembershipRule
有关详细信息,请参阅 Add-CMDeviceCollectionDirectMembershipRule。
已修复的 Bug
修复了重复设备编号检查的问题。
Add-CMManagementPoint
有关详细信息,请参阅 Add-CMManagementPoint。
已修复的 Bug
修复了云管理网关支持的问题。
Add-CMPassiveSite
有关详细信息,请参阅 Add-CMPassiveSite。
已修复的 Bug
修复了层次结构中被动站点的问题。
Add-CMTaskSequenceStep
有关详细信息,请参阅 Add-CMTaskSequenceStep。
已修复的 Bug
修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。
Add-CMWindowsAppxDeploymentType
有关详细信息,请参阅 Add-CMWindowsAppxDeploymentType。
非中断性变更
添加了支持 MSIX 的函数。
Approve-CMDevice
有关详细信息,请参阅 Approve-CMDevice。
非中断性变更
修复了使用 Get-CMDevice 时出现的问题。
Enable-CMSiteFeature
有关详细信息,请参阅 Enable-CMSiteFeature。
非中断性变更
添加了支持云功能的新标志。
Get-CMScript
有关详细信息,请参阅 Get-CMScript。
非中断性变更
添加了新的参数 ScriptGuid 以支持通过脚本 GUID 进行查询。
Get-CMSiteFeature
有关详细信息,请参阅 Get-CMSiteFeature。
非中断性变更
添加了支持云功能的新标志。
Get-CMSoftwareUpdate
有关详细信息,请参阅 Get-CMSoftwareUpdate。
非中断性变更
添加了新的参数 Vendor 以指定软件更新的源。
示例:
Get-CMSoftwareUpdate -Name $Update -Vendor "Microsoft"
Get-CMStatusMessageQuery
有关详细信息,请参阅 Get-CMStatusMessageQuery。
已修复的 Bug
修复了参数 ShowMessage 的问题。
Import-CMDriver
有关详细信息,请参阅 Import-CMDriver。
非中断性变更
添加了新的参数 AdministrativeCategoryName ,以指定驱动程序类别的名称。
示例:
Import-CMDriver -UncFileLocation $DriverFolder -ImportFolder -ImportDuplicateDriverOption AppendCategory -AdministrativeCategory "Video drivers"
Invoke-CMAnalyzePackage
有关详细信息,请参阅 Invoke-CMAnalyzePackage。
中断性变更
删除了 Package 参数。 通过管道传递包对象,或使用 InputObject 参数。
非中断性变更
添加了管道支持和 InputObject 参数。
示例:
$pkg | Invoke-CMAnalyzePackage
Invoke-CMClientAction
有关详细信息,请参阅 Invoke-CMClientAction。
已修复的 Bug
修复了参数 集合的管道问题。
示例:
Get-CMCollection -Name "deviceCol1" | Invoke-CMClientAction -ActionType ClientNotificationRequestUsersPolicyNow
Invoke-CMConvertPackage
有关详细信息,请参阅 Invoke-CMConvertPackage。
中断性变更
删除了 Package 参数。 通过管道传递包对象,或使用 InputObject 参数。
非中断性变更
添加了管道支持和 InputObject 参数。
示例:
$pkg | Invoke-CMConvertPackage
Invoke-CMReport
有关详细信息,请参阅 Invoke-CMReport。
已修复的 Bug
修复了参数 Path 的问题。
Invoke-CMScript
有关详细信息,请参阅 Invoke-CMScript。
非中断性变更
添加参数 ScriptParameter 以将参数传递给目标脚本。
示例:
$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash
New-CMBMSClientConfigureCheckIntervalPolicy
有关详细信息,请参阅 New-CMBMSClientConfigureCheckIntervalPolicy。
已修复的 Bug
修复了创建新策略设置实例时出现的问题。
New-CMBoundary
有关详细信息,请参阅 New-CMBoundary。
非中断性变更
在 BoundaryType 参数中添加了 VPN 选项。
New-CMBootableMedia
有关详细信息,请参阅 New-CMBootableMedia。
非中断性变更
添加参数 SiteCode。
New-CMCloudManagementGateway
有关详细信息,请参阅 New-CMCloudManagementGateway。
非中断性变更
以下参数是新的:
- CARootCert
- EnableCloudDPFunction
- EnableStorageQuota
- EnableTrafficOut
- EnforceProtocol
- Force
- GroupName
- IsUsingExistingGroup
- ServerAppClientID
- ServiceCertPassword
- ServiceCertPath
- ServiceName
- StorageCriticalPct
- StorageQuotaGB
- StorageWarningPct
- TrafficOutStopService
以下参数已更新:
- CheckClientCertRevocation
- EnvironmentSetting
- 地区
- SubscriptionId
- TrafficCriticalPct
- TrafficWarningPct
中断性变更
将从此 cmdlet 中删除以下参数:
- GovernmentSubscription
- ManagementCertificatePassword
- ManagementCertificatePath
- PassThru
- RootCertificatePath
- ServiceCertificatePassword
- ServiceCertificatePath
- ServiceCName
New-CMCoManagementPolicy
有关详细信息,请参阅 New-CMCoManagementPolicy。
非中断性变更
添加了多会话适用性
添加了 ARM64 适用性
New-CMComplianceRuleFileFolderDate
有关详细信息,请参阅 New-CMComplianceRuleFileFolderDate。
非中断性变更
调整了 cmdlet 逻辑,以处理 参数“修改 ”和 “创建” 中的值,以与其他 cmdlet 保持一致。
New-CMComplianceRuleFileFolderSimple
有关详细信息,请参阅 New-CMComplianceRuleFileFolderSimple。
中断性变更
将参数 PropertyType 的类型从 FileFolderProperty 更改为 SimpleFileFolderProperty 类型。
New-CMDetectionClauseDirectory
有关详细信息,请参阅 New-CMDetectionClauseDirectory。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 FileFolderRuleExpressionOperator 类型。
New-CMDetectionClauseFile
有关详细信息,请参阅 New-CMDetectionClauseFile。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 FileFolderRuleExpressionOperator 类型。
New-CMDetectionClauseMacBundle
有关详细信息,请参阅 New-CMDetectionClauseMacBundle。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 MacRuleExpressionOperator 类型。
已修复的 Bug
修复了参数 PropertyType 的问题。
New-CMDetectionClauseMacPackage
有关详细信息,请参阅 New-CMDetectionClauseMacPackage。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 MacRuleExpressionOperator 类型。
New-CMDetectionClauseRegistryKeyValue
有关详细信息,请参阅 New-CMDetectionClauseRegistryKeyValue。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 RegistryValueRuleExpressionOperator 类型。
New-CMDetectionClauseWindowsInstaller
有关详细信息,请参阅 New-CMDetectionClauseWindowsInstaller。
中断性变更
将参数 ExpressionOperator 的类型从 RuleExpressionOperator 更改为 WindowsInstallerRuleExpressionOperator 类型。
New-CMDriverPackage
有关详细信息,请参阅 New-CMDriverPackage。
已修复的 Bug
修复了参数 DriverModel 的问题。
New-CM*PhasedDeployment
有关详细信息,请参阅以下文章:
- New-CMApplicationAutoPhasedDeployment
- New-CMSoftwareUpdateAutoPhasedDeployment
- New-CMSoftwareUpdateManualPhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
已修复的 Bug
修复了参数 WhatIf 的问题。
非中断性变更
添加了对重复阶段名称的验证。
New-CMPrestageMedia
有关详细信息,请参阅 New-CMPrestageMedia。
非中断性变更
添加参数 SiteCode。
New-CMProgram
有关详细信息,请参阅 New-CMProgram。
中断性变更
已将参数 DriveMode 的类型RenameWithUncRunWithUnc重命名为 。
New-CMSoftwareUpdateDeployment
有关详细信息,请参阅 New-CMSoftwareUpdateDeployment。
非中断性变更
为未下载的软件更新添加了新参数 DeployWithNoPackage 。
New-CMStandaloneMedia
有关详细信息,请参阅 New-CMStandaloneMedia。
已修复的 Bug
修复了参数 PrestartPackage 的问题
New-CMTaskSequence
有关详细信息,请参阅 New-CMTaskSequence。
已修复的 Bug
修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。
New-CMTaskSequenceDeployment
有关详细信息,请参阅 New-CMTaskSequenceDeployment。
已修复的 Bug
修复了参数 AllowFallback 的问题。
非中断性变更
添加了对参数 Schedule 的验证,以避免现有赋值重复。
New-CMTaskSequenceMedia
有关详细信息,请参阅 New-CMTaskSequenceMedia。
非中断性变更
将媒体创建中的超时时间从一天更改为三天。
New-CMTSPartitionSetting
有关详细信息,请参阅 New-CMTSPartitionSetting。
已修复的 Bug
修复了参数 EnableQuickFormat 的问题。
New-CMTSStepEnableBitLocker
有关详细信息,请参阅 New-CMTSStepEnableBitLocker。
已修复的 Bug
修复了用户指定的加密方法的问题。
New-CMTSStepOfflineEnableBitLocker
有关详细信息,请参阅 New-CMTSStepOfflineEnableBitLocker。
已修复的 Bug
修复了用户指定的加密方法的问题。
New-CMTSStepPreStartCheck
有关详细信息,请参阅 New-CMTSStepPreStartCheck。
已修复的 Bug
修复了新检查就绪步骤的问题。
修复了参数 OSLanguageId 的问题。
非中断性变更
为 UEFI 检查 CheckUefi 添加新参数。
Remove-CMTaskSequenceGroup
有关详细信息,请参阅 Remove-CMTaskSequenceGroup。
已修复的 Bug
修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。
Set-CM*PhasedDeployment
有关详细信息,请参阅以下文章:
- Set-CMApplicationPhasedDeployment
- Set-CMSoftwareUpdatePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
已修复的 Bug
修复了参数 WhatIf 的问题。
Set-CMBoundary
有关详细信息,请参阅 Set-CMBoundary。
非中断性变更
在 BoundaryType 中添加VPN了选项。
Set-CMClientSettingComputerRestart
有关详细信息,请参阅 Set-CMClientSettingComputerRestart。
非中断性变更
添加了一个新参数 NoRebootEnforcement。
Set-CMClientSettingSoftwareUpdate
有关详细信息,请参阅 Set-CMClientSettingSoftwareUpdate。
非中断性变更
添加了参数:
- EnableInstallation
- ThreadPriority
- EnableDynamicUpdate
示例:
Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true
Set-CMCloudManagementGateway
有关详细信息,请参阅 Set-CMCloudManagementGateway。
非中断性变更
以下参数是新的:
- CARootCert
- EnableCloudDPFunction
- EnableStorageQuota
- EnableTrafficOut
- EnforceProtocol
- RemoveCertThumbprints
- StorageCriticalPct
- StorageQuotaGB
- StorageWarningPct
- TrafficOutStopService
- VMInstanceCount
中断性变更
将从此 cmdlet 中删除以下参数:
- VMInstancesCount
Set-CMDiscoveryMethod
有关详细信息,请参阅 Set-CMDiscoveryMethod。
已修复的 Bug
修复了参数 AddGroupDiscoveryScope 的问题。
Set-CMDistributionPoint
有关详细信息,请参阅 Set-CMDistributionPoint。
非中断性变更
添加了支持Microsoft连接缓存的参数:
- EnableDoinc
- DiskSpaceUnit
- DiskSpaceDoinc
- LocalDriveDoinc
- RetainDoincCache
- AgreeDoincLicense
示例:
$dp | Set-CMDistributionPoint -EnableDoinc $true -AgreeDoincLicense $true
$dp | Set-CMDistributionPoint -RetainDoincCache $true -EnableDoinc $true -AgreeDoincLicense $true
$dp | Set-CMDistributionPoint -LocalDriveDoinc "Z:" -DiskSpaceDoinc 9000 -DiskSpaceUnit GB
Set-CMDriverPackage
有关详细信息,请参阅 Set-CMDriverPackage。
已修复的 Bug
修复了参数 DriverModel 的问题。
Set-CMManagementPoint
有关详细信息,请参阅 Set-CMManagementPoint。
已修复的 Bug
修复了云管理网关支持的问题。
Set-CMProgram
有关详细信息,请参阅 Set-CMProgram。
中断性变更
已将参数 DriveMode 的类型RenameWithUncRunWithUnc重命名为 。
Set-CMSiteMaintenanceTask
有关详细信息,请参阅 Set-CMSiteMaintenanceTask。
非中断性变更
添加了以下新参数,用于为具有远程 SMS 提供程序的环境配置站点备份目标和 SQL 备份目标:
- SiteBackupPath
- SqlBackupPath
示例:
Set-CMSiteMaintenanceTask -Name $TaskName -SiteBackupPath "c:\site-backup" -SqlBackupPath "c:\sql-backup" -BeginTime (Get-Date) -DaysOfWeek Sunday,Monday -EnableAlert $true -Enabled $true
Set-CMSoftwareUpdateAutoDeploymentRule
有关详细信息,请参阅 Set-CMSoftwareUpdateAutoDeploymentRule。
已修复的 Bug
修复了 Get-CMSoftwareUpdateAutoDeploymentRule 中具有 Fast 选项的输入对象的问题。
Set-CMSoftwareUpdateDeploymentPackage
有关详细信息,请参阅 Set-CMSoftwareUpdateDeploymentPackage。
已修复的 Bug
修复了参数 RemoveExpired 和 RemoveSuperceded 的问题。
Set-CMSoftwareUpdateGroup
有关详细信息,请参阅 Set-CMSoftwareUpdateGroup。
已修复的 Bug
修复了添加未下载的软件更新的问题。
Set-CMStatusFilterRule
有关详细信息,请参阅 Set-CMStatusFilterRule。
已修复的 Bug
修复了 Name 参数的问题,以确保它包含 Get-CMStatusFilterRule。
Set-CMTaskSequenceDeployment
有关详细信息,请参阅 Set-CMTaskSequenceDeployment。
已修复的 Bug
修复了参数 ScheduleEvent 的问题。
修复了参数 AllowFallback 的问题。
非中断性变更
添加了对参数 Schedule 的验证,以避免现有赋值重复。
添加了用于配置计划的新参数:
- ClearSchedule
- RemoveSchedule
- AddSchedule
添加了用于配置 ScheduleEvent 的新参数:
- ClearScheduleEvent
- RemoveScheduleEvent
- AddScheduleEvent
示例:
$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddSchedule $schedule1, $schedule2
$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff
Set-CMTSStep*
已修复的 Bug
修复了使用包含大型脚本的多个 PowerShell 步骤时的策略大小问题。
Set-CMTSStepEnableBitLocker
有关详细信息,请参阅 Set-CMTSStepEnableBitLocker。
已修复的 Bug
修复了用户指定的加密方法的问题。
Set-CMTSStepOfflineEnableBitLocker
有关详细信息,请参阅 Set-CMTSStepOfflineEnableBitLocker。
已修复的 Bug
修复了用户指定的加密方法的问题。
Set-CMTSStepPreStartCheck
有关详细信息,请参阅 Set-CMTSStepPreStartCheck。
非中断性变更
为 UEFI 添加了一个新参数检查:, CheckUefi。
Set-CMWindowsAppxDeploymentType
有关详细信息,请参阅 Set-CMWindowsAppxDeploymentType。
非中断性变更
添加了支持 MSIX 的函数。
Start-CMCloudManagementGateway
有关详细信息,请参阅 Start-CMCloudManagementGateway。
已修复的 Bug
更正了 CMG 状态的验证。
Start-CMContentDistribution
有关详细信息,请参阅 Start-CMContentDistribution。
非中断性变更
添加了参数 DeploymentPackageId 和 DeploymentPackageName 的别名,以便更好地了解。
Stop-CMCloudManagementGateway
有关详细信息,请参阅 Stop-CMCloudManagementGateway。
已修复的 Bug
更正了 CMG 状态的验证。
如何提供反馈或报告问题
本文中所述的许多修复和改进都是你的反馈的结果。
若要发送反馈,请使用 Configuration Manager 控制台。 有关详细信息,请参阅 PowerShell 的反馈。