適用於:設定管理員 (目前的分支)
這些釋出說明總結了 2010 版中 設定管理員 指令庫的變更。
自 2010 版本起,設定管理員 PowerShell 指令庫現已支援 PowerShell 7。 欲了解更多資訊,請參閱 PowerShell 版本 7 的支援。
注意事項
設定管理員 目前分支版本 2002 是這些變更的基準。 欲了解更多資訊,請參閱 設定管理員 cmdlet 函式庫對 2006 版本的變更。
雲端管理閘道
隨著越來越多客戶管理遠端裝置,本版本包含多個全新且改良的 Windows PowerShell 指令匣,用於 CMG) (雲端管理閘道。 你可以利用這些 cmdlet 自動化 CMG 服務的建立、設定和管理,並Azure Active Directory (Azure AD) 需求。
注意事項
雖然部分新指令小程式可能能與其他 Azure 服務使用,但它們僅在雲端管理連線下測試以支援 CMG。
例如,Azure管理員首先在 Active Directory (Azure AD) 建立兩個必需的應用程式Azure。 接著你寫一個腳本,使用以下 cmdlet 來部署 CMG:
- Import-CMAADServerApplication: Create the Azure AD server app definition in 設定管理員.
- Import-CMAADClientApplication: Create the Azure AD client app definition in 設定管理員.
- 使用 Get-CMAADApplication 取得應用程式物件,然後傳給 New-CMCloudManagementAzureService,在 設定管理員 建立 Azure 服務連線。
- New-CMCloudManagementGateway: Create the CMG service in Azure.
- Add-CMCloudManagementGatewayConnectionPoint:建立 CMG 連接點站點系統。
CMG 的新指令匣
- Get-CMAADApplication:從網站取得 Azure Active Directory (Azure AD) 應用程式物件。
- Get-CMAzureService: Get the Azure service.
- Import-CMAADClientApplication: 從 Azure AD 匯入客戶端應用程式,並為 設定管理員 site 定義它。
- Import-CMAADServerApplication:從 Azure AD 匯入 web/server app,並為 設定管理員 網站定義它。
- New-CMCloudManagementAzureService: Create the Azure service for Cloud Management in 設定管理員.
- Remove-CMAzureService: Remove the Azure service.
- Set-CMCloudManagementAzureService:修改Azure服務的雲端管理設定,設定管理員。
CMG 的更新 cmdlets
以下現有指令小子有顯著改進。 欲了解更多資訊,請參閱以下發行說明:
CMG 現有的指令小節
你可以繼續使用以下現有的 CMG 指令集:
- Add-CMCloudManagementGatewayConnectionPoint
- Get-CMCloudManagementGateway
- Get-CMCloudManagementGatewayConnectionPoint
- New-CMCloudManagementGateway
- Remove-CMCloudManagementGateway
- Remove-CMCloudManagementGatewayConnectionPoint
- Set-CMCloudManagementGateway
- Set-CMCloudManagementGatewayConnectionPoint
- Start-CMCloudManagementGateway
- Stop-CMCloudManagementGateway
新指令小程式
應用程式管理
- Add-CMCIDectionMethod:指定用戶端如何偵測應用程式。
- Get-CMApplicationGroupDeployment:取得應用程式群組的部署。
- New-CMApplicationGroupDeployment:為應用程式群組建立部署。
- 移除-CMApplicationGroupDeployment:移除應用程式群組的部署。
- Set-CMApplicationGroupDeployment:配置應用程式群組的部署。
館藏管理
- Get-CMCollectionDependency:取得目標集合的極限集合。
- Get-CMCollectionDependent:取得集合的依賴關係。
- 取得-CMCollectionEvaluationStatus:取得收藏評估的狀態。
- 取得 CMCollectionFullEvaluationStatus:取得一個集合的完整評估狀態。
- 取得 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 個人檔案
- 取得 CMOneDriveBusinessProfile:取得 商務用 OneDrive 個人檔案的保單。
- New-CMOneDriveBusinessProfile:建立商務用 OneDrive 個人檔案政策。
- Set-CMOneDriveBusinessProfile:設定一個商務用 OneDrive 設定檔政策。
已棄用與移除的指令檔
以下針對 設定管理員 混合環境的指令小檔已不再提供:
- Add-CMAndroidDeploymentType
- Add-CMGooglePlayDeploymentType
- Add-CMIosAppStoreDeploymentType
- Add-CMIosDeploymentType
- Set-CMAndroidDeploymentType
- Set-CMGooglePlayDeploymentType
- Set-CMIosAppStoreDeploymentType
- Set-CMIosDeploymentType
欲了解更多資訊,請參閱 「混合式MDM發生了什麼事?」
以下指令檔已被棄用:
已知問題
無
指令長變更
本版本對現有指令庫做了以下變更。 變更可能是新功能、錯誤修正或棄用。 有些變動可能會出現問題。 如果您使用本節列出的指令碼或功能區域,請仔細檢視變更,了解它們可能對您的使用造成的影響。
Add-CMComplianceSettingRegistryKeyValue
欲了解更多資訊,請參閱 Add-CMComplianceSettingRegistryKeyValue。
非破壞性變更
參數 期望值 可以接受空值。
Add-CMDistributionPoint
欲了解更多資訊,請參閱 Add-CMDistributionPoint。
已修正的錯誤
修正了分銷點建立的問題。
Add-CMDeviceCollectionDirectMembershipRule
欲了解更多資訊,請參閱 Add-CMDeviceCollectionDirectMembershipRule。
已修正的錯誤
修正了重複裝置號碼檢查的問題。
Add-CMManagementPoint
欲了解更多資訊,請參閱 Add-CMManagementPoint。
已修正的錯誤
解決了雲端管理閘道支援的問題。
Add-CMPassiveSite
欲了解更多資訊,請參閱 Add-CMPassiveSite。
已修正的錯誤
修正了階層中被動站點的問題。
Add-CMTaskSequenceStep
欲了解更多資訊,請參閱 Add-CMTaskSequenceStep。
已修正的錯誤
在使用包含大型腳本的多個 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。
已修正的錯誤
修正了 ShowMessage 參數的問題。
Import-CMDriver
更多資訊請參見 Import-CMDriver。
非破壞性變更
新增了 AdministrativeCategoryName 參數,以指定驅動類別的名稱。
範例:
Import-CMDriver -UncFileLocation $DriverFolder -ImportFolder -ImportDuplicateDriverOption AppendCategory -AdministrativeCategory "Video drivers"
Invoke-CMAnalyzePackage
欲了解更多資訊,請參閱 Invoke-CMAnalyzePackage。
重大變更
移除了 套件 參數。 將套件物件設管道,或使用 InputObject 參數。
非破壞性變更
新增了管線支援及 InputObject 參數。
範例:
$pkg | Invoke-CMAnalyzePackage
Invoke-CMClientAction
欲了解更多資訊,請參閱 Invoke-CMClientAction。
已修正的錯誤
參數 收集的管線問題已解決。
範例:
Get-CMCollection -Name "deviceCol1" | Invoke-CMClientAction -ActionType ClientNotificationRequestUsersPolicyNow
Invoke-CMConvertPackage
欲了解更多資訊,請參閱 Invoke-CMConvertPackage。
重大變更
移除了 套件 參數。 將套件物件設管道,或使用 InputObject 參數。
非破壞性變更
新增了管線支援及 InputObject 參數。
範例:
$pkg | Invoke-CMConvertPackage
Invoke-CMReport
欲了解更多資訊,請參閱 Invoke-CMReport。
已修正的錯誤
修正了參數 路徑的問題。
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。
已修正的錯誤
在建立新政策設定實例時修正了一個問題。
New-CMBoundary
欲了解更多資訊,請參閱 New-CMBoundary。
非破壞性變更
在 BoundaryType 參數中新增了 VPN 選項。
New-CMBootableMedia
欲了解更多資訊,請參閱 New-CMBootableMedia。
非破壞性變更
新增參數 SiteCode。
New-CMCloudManagementGateway
欲了解更多資訊,請參閱 New-CMCloudManagementGateway。
非破壞性變更
以下參數是新的:
- CARootCert
- 啟用雲端DPFunction
- EnableStorageQuota
- EnableTrafficOut
- 執行協議
- 兵力
- GroupName
- IsUsingExistingGroup
- ServerAppClientID
- ServiceCertPassword
- ServiceCertPath
- 服務名稱
- 儲存關鍵PCT
- StorageQuotaGB
- 儲存警告程式
- 交通停停服務
以下參數已更新:
- CheckClientCertRevocation
- 環境設定
- 區域
- SubscriptionId
- TrafficCriticalPCT 交通關鍵
- 交通警告公共服務
重大變更
以下參數從此指令小程式中移除:
- 政府訂閱
- 管理憑證密碼
- 管理憑證路徑
- 直通
- RootCertificatePath
- 服務憑證密碼
- 服務憑證路徑
- ServiceCName
New-CMCoManagementPolicy
欲了解更多資訊,請參閱 New-CMCoManagementPolicy。
非破壞性變更
新增多重會話適用性
新增 ARM64 適用性
New-CMComplianceRuleFileFolderDate
欲了解更多資訊,請參閱 New-CMComplianceRuleFileFolderDate。
非破壞性變更
調整了指令檔邏輯,讓參數 Modification 和 Creation 的值能與其他指令集對齊。
New-CMComplianceRuleFileFolderSimple
欲了解更多資訊,請參閱 New-CMComplianceRuleFileFolderSimple。
重大變更
將參數 PropertyType 的類型從 FileFolderProperty 改為 SimpleFileFolderProperty 。
New-CMDetectionClauseDirectory
欲了解更多資訊,請參閱 New-CMDectionClauseDirectory。
重大變更
將參數 ExpressionOperator 的類型從 RuleExpressionOperator 改為 FileFolderRuleExpressionOperator 類型。
New-CMDetectionClauseFile
欲了解更多資訊,請參閱 New-CMDectionClauseFile。
重大變更
將參數 ExpressionOperator 的類型從 RuleExpressionOperator 改為 FileFolderRuleExpressionOperator 類型。
New-CMDetectionClauseMacBundle
更多資訊請參見 New-CMDectionClauseMacBundle。
重大變更
將參數 ExpressionOperator 的類型從 RuleExpressionOperator 改為 MacRuleExpressionOperator 類型。
已修正的錯誤
修正了參數 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。
已修正的錯誤
修正了參數 DriverModel 的問題。
New-CM*分階段部署
如需詳細資訊,請參閱下列文章:
- New-CMApplicationAutoPhasedDeployment
- New-CMSoftwareUpdateAutoPhasedDeployment
- New-CMSoftware更新手續分階段部署
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequence Manual分階段部署
已修正的錯誤
修正了參數 WhatIf 的問題。
非破壞性變更
新增了重複相位名稱的驗證功能。
New-CMPrestageMedia
欲了解更多資訊,請參閱 New-CMPrestageMedia。
非破壞性變更
新增參數 SiteCode。
New-CMProgram
欲了解更多資訊,請參閱 New-CMProgram。
重大變更
將參數 DriveMode 的類型RenameWithUnc重新命名為 。RunWithUnc
New-CMSoftwareUpdateDeployment
更多資訊請參見 New-CMSoftwareUpdateDeployment。
非破壞性變更
新增參數 DeployWithNoPackage 用於非下載軟體更新。
New-CMStandaloneMedia
欲了解更多資訊,請參閱 New-CMStandaloneMedia。
已修正的錯誤
已修正參數 PrestartPackage 的問題
New-CMTaskSequence
欲了解更多資訊,請參閱 New-CMTaskSequence。
已修正的錯誤
修正了使用多個包含大型腳本的 PowerShell 步驟時的政策大小問題。
New-CMTaskSequenceDeployment
欲了解更多資訊,請參閱 New-CMTaskSequenceDeployment。
已修正的錯誤
修正了參數 允許備援的問題。
非破壞性變更
新增參數 排程 的驗證功能,以避免與現有指派重複值。
New-CMTaskSequenceMedia
欲了解更多資訊,請參閱 New-CMTaskSequenceMedia。
非破壞性變更
媒體製作的超時時間從一天改成三天。
New-CMTSPartitionSetting
欲了解更多資訊,請參閱 New-CMTSPartitionSetting。
已修正的錯誤
修正了參數 EnableQuickFormat 的問題。
New-CMTSStepEnableBitLocker
欲了解更多資訊,請參閱 New-CMTSStepEnableBitLocker。
已修正的錯誤
修正了使用者自訂加密方法的問題。
New-CMTSStepOfflineEnableBitLocker
欲了解更多資訊,請參閱 New-CMTSStepOfflineEnableBitLocker。
已修正的錯誤
修正了使用者自訂加密方法的問題。
New-CMTSStepPreStartCheck
欲了解更多資訊,請參閱 New-CMTSStepPreStartCheck。
已修正的錯誤
修正了新的檢查準備步驟的問題。
修正了 OSLanguageID 參數的問題。
非破壞性變更
新增一個 UEFI 檢查參數 CheckUefi。
Remove-CMTaskSequenceGroup
欲了解更多資訊,請參閱 Remove-CMTaskSequenceGroup。
已修正的錯誤
修正了使用多個包含大型腳本的 PowerShell 步驟時的政策大小問題。
Set-CM*分階段部署
如需詳細資訊,請參閱下列文章:
已修正的錯誤
修正了參數 WhatIf 的問題。
Set-CMBoundary
欲了解更多資訊,請參閱 Set-CMBoundary。
非破壞性變更
在 BoundaryType 中新增VPN了選項。
Set-CMClientSettingComputerRestart
更多資訊請參見 Set-CMClientSettingComputerRestart。
非破壞性變更
新增了一個參數 NoRebootEnforcement。
Set-CMClientSettingSoftwareUpdate
欲了解更多資訊,請參閱 Set-CMClientSettingSoftwareUpdate。
非破壞性變更
新增參數:
- 啟用安裝
- 線程優先權
- 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
- 啟用雲端DPFunction
- EnableStorageQuota
- EnableTrafficOut
- 執行協議
- 移除CertThumbprints
- 儲存關鍵PCT
- StorageQuotaGB
- 儲存警告程式
- 交通停停服務
- VMInstanceCount
重大變更
以下參數從此指令小程式中移除:
- 維吉尼亞軍事狀況伯爵
Set-CMDiscoveryMethod
欲了解更多資訊,請參閱 Set-CMDiscoveryMethod。
已修正的錯誤
已修正參數 AddGroupDiscoveryScope 的問題。
Set-CMDistributionPoint
欲了解更多資訊,請參閱 Set-CMDistributionPoint。
非破壞性變更
新增參數以支援 Microsoft Connected 快取:
- 恩布爾多因克
- 磁碟空間單元
- 磁碟空間多因克
- LocalDriveDoinc
- RetainDoinc快取
- 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。
已修正的錯誤
修正了參數 DriverModel 的問題。
Set-CMManagementPoint
欲了解更多資訊,請參閱 Set-CMManagementPoint。
已修正的錯誤
解決了雲端管理閘道支援的問題。
Set-CMProgram
欲了解更多資訊,請參閱 Set-CMProgram。
重大變更
將參數 DriveMode 的類型RenameWithUnc重新命名為 。RunWithUnc
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。
已修正的錯誤
修正了 Get-CMSoftwareUpdateAutoDeploymentRule輸入物件 的快速選項問題。
Set-CMSoftwareUpdateDeploymentPackage
欲了解更多資訊,請參閱 Set-CMSoftwareUpdateDeploymentPackage。
已修正的錯誤
修正了 RemoveExpired 和 RemoveSuperceed(已移除)參數的問題。
Set-CMSoftwareUpdateGroup
欲了解更多資訊,請參閱 Set-CMSoftwareUpdateGroup。
已修正的錯誤
修正了新增未下載軟體更新的問題。
Set-CMStatusFilterRule
欲了解更多資訊,請參閱 Set-CMStatusFilterRule。
已修正的錯誤
修正了 Name 參數的問題,確保它包含 Get-CMStatusFilterRule。
Set-CMTaskSequenceDeployment
欲了解更多資訊,請參閱 Set-CMTaskSequenceDeployment。
已修正的錯誤
修正了參數 ScheduleEvent 的問題。
修正了參數 允許備援的問題。
非破壞性變更
新增參數 排程 的驗證功能,以避免與現有指派重複值。
新增參數以設定排程:
- 清空行程
- 移除行程
- 新增行程
新增參數以設定 ScheduleEvent:
- ClearScheduleEvent
- 移除行程事件
- AddScheduleEvent
範例:
$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddSchedule $schedule1, $schedule2
$ReferenceDeployment | Set-CMTaskSequenceDeployment -AddScheduleEvent LogOn, LogOff
Set-CMTSStep*
已修正的錯誤
修正了使用多個包含大型腳本的 PowerShell 步驟時的政策大小問題。
Set-CMTSStepEnableBitLocker
欲了解更多資訊,請參閱 Set-CMTSStepEnableBitLocker。
已修正的錯誤
修正了使用者自訂加密方法的問題。
Set-CMTSStepOfflineEnableBitLocker
欲了解更多資訊,請參閱 Set-CMTSStepOfflineEnableBitLocker。
已修正的錯誤
修正了使用者自訂加密方法的問題。
Set-CMTSStepPreStartCheck
欲了解更多資訊,請參閱 Set-CMTSStepPreStartCheck。
非破壞性變更
新增了一個 UEFI 檢查參數, CheckUefi。
Set-CMWindowsAppxDeploymentType
更多資訊請參閱 Set-CMWindowsAppxDeploymentType。
非破壞性變更
新增支援 MSIX 的功能。
Start-CMCloudManagementGateway
欲了解更多資訊,請參閱 Start-CMCloudManagementGateway。
已修正的錯誤
修正了 CMG 狀態的驗證。
Start-CMContentDistribution
欲了解更多資訊,請參閱 Start-CMContentDistribution。
非破壞性變更
新增參數 DeploymentPackageID 與 DeploymentPackageName 的別名,以便更易理解。
Stop-CMCloudManagementGateway
欲了解更多資訊,請參閱 Stop-CMCloudManagementGateway。
已修正的錯誤
修正了 CMG 狀態的驗證。
如何提供回饋或回報問題
本文中描述的許多修正與改進都是基於您的回饋。
要傳送回饋,請使用 設定管理員 主控台。 欲了解更多資訊,請參閱 PowerShell 回饋。