Configuration Manager 1902 版的 Cmdlet 程式庫變更

  • 發行項

適用於：Configuration Manager (目前的分支)

注意事項

Configuration Manager最新分支版本 1810 是這些變更的基準。 如需詳細資訊，請參閱 Configuration Manager 1810 版的 Cmdlet 程式庫變更。

重要變更

新的 Cmdlet

Get-CMBoundaryGroupSiteSystem

使用此 Cmdlet 取得指定界限群組中的月臺系統。

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID

Get-CMDistributionPointDriveInfo

使用此 Cmdlet 取得發佈點磁片磁碟機資訊。

$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName 
$dp | Get-CMDistributionPointDriveInfo

Invoke-CMAnalyzePackage

使用此 Cmdlet 來分析特定套件。

Invoke-CMAnalyzePackage -PackageName $packageName

Invoke-CMConvertPackage

使用此 Cmdlet 將特定封裝轉換成應用程式。

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

使用此 Cmdlet 建立新的 PowerShell 腳本。 它只支援不包含任何參數的腳本。

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1

Set-CMClientSettingDeliveryOptimization

使用此 Cmdlet 來設定傳遞優化功能的用戶端設定。

[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true

Set-CMClientSettingWindowsAnalytics

使用此 Cmdlet 來設定 Windows Analytics 功能的用戶端設定。

[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones

已移除 Cmdlet

無

已淘汰的 Cmdlet

無

已知問題

下列專案是此版本中未解決的 Cmdlet 程式庫已知問題。

Get-CMAadConditionalAccessPolicy和Set-CMAadConditionalAccessPolicy

這些 Cmdlet 需要 64 位 PowerShell 環境。

因應措施

  • 無

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 進行下列變更。 變更可能是新功能、錯誤修正或取代。 某些變更可能會中斷。 如果您使用本節所列的其中一個 Cmdlet 或功能區域，請仔細檢閱變更，以瞭解這些變更可能會對您的使用造成何種影響。

Add-CMDeviceAffinityToUser

已修正的錯誤

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName 需要同時使用 「-DeviceId/-DeviceName」。

非中斷性變更

  • 已新增 -DeviceID 和 -DeviceName 的參數檢查，使用者應該至少指定其中一個。

Add-CMDeviceCollectionDirectMembershipRule

已修正的錯誤

  • 在 PowerShell 中使用 'Add-CMDeviceCollectionDirectMembershipRule' 命令將相同的資源新增至相同的集合時，它會顯示空白警告 「WARNING： 」 ，而且不會顯示錯誤「具有指定名稱的物件已經存在」。

非中斷性變更

  • 已新增遺漏的資源。

Add-CMDistributionPoint

非中斷性變更

  • 已新增 「-EnableLedbat」 參數，以在 DP 上啟用/停用 LEDBAT

Add-CMScriptDeploymentType

已修正的錯誤

  • 預設Add-CMScriptDeploymentType與 UI 不一致

非中斷性變更

  • 修改了初始化程式碼，以與 UI 一致 (估計安裝時間 = 0，登入需求=只有當使用者登入) 時。

Approve-CMApprovalRequest

非中斷性變更

  • 已新增參數 InstallActionBehavior (有兩個選項：InstallNow、InstallNonBusinessHours) ，系統管理員可以指定是否要在應用程式核准後立即安裝應用程式，或在非上班時間安裝應用程式。 它是選擇性參數，預設等於 「InstallNow」。

Get-CMDevice

已修正的錯誤

  • Get-CMDevice遺漏 SMSAssignedSites 屬性 - 這是 1806 年之前提供的屬性。

非中斷性變更

  • 已新增兩個新的參數，以允許客戶指定輸出的類別：

    • -ReturnCollectionMember：會強制傳回 sms 集合成員類別的實例
    • -ReturnResource：會強制傳回SMS_Resource類別的實例。

    如果您使用沒有 ReturnCollectionMember/ReturnResource 的預設參數，則行為會與 1802/1810 相同：傳回的實例可能位於具有不同指定參數的不同類別中。

Get-CMPackage

已修正的錯誤

  • Get-CMPackage需要 -Fast 參數

非中斷性變更

  • 已新增 -Fast 參數以支援快速查詢。

Import-CMDriver

已修正的錯誤

  • Set-CMDriver - 陣列的 SupportedPlatformName 將會失敗

非中斷性變更

  • 已修正 SupportPlatformName 參數的陣列值問題。

Invoke-CMScript

已修正的錯誤

  • Invoke-CMScript Cmdlet 預期無法取得物件。

非中斷性變更

  • 已更正類型驗證。

New-CMActiveDirectoryForest

已修正的錯誤

  • 建立 Active Directory 樹系 - 使用者無法透過 Powershell 運作，只有在透過 GUI 建立時才能運作。

非中斷性變更

  • 在使用者設定認證之後，將帳戶匯入至通用帳戶。
  • 已新增新的參數 -Password 以使用密碼建立認證。

New-CMApplication

已修正的錯誤

  • 使用者無法使用 New-CMApplication Cmdlet 指定空白的 Owner 或 SupportContact 參數

非中斷性變更

  • 建立新的應用程式時，允許 owner/SupportContact 的$null，預設值會是目前的使用者。
  • 已新增 Owner/SupportContact 的新參數以支援陣列輸入。

New-CMApplicationDeployment

非中斷性變更

  • 已新增新的參數 ReplaceToastNotificationWithDialog (布林值) ，當用戶端電腦上有可用的必要軟體時，系統管理員可以指定是否要將快顯通知取代為對話方塊。 它是選擇性參數，預設為 false。

New-CMCoManagementPolicy

非中斷性變更

  • 已新增 DCWorkloadEnabled、O365WorkloadEnabled、ClientAppsWorkloadEnabled () 的新工作負載支援。

New-CMDetectionClauseWindowsInstaller

已修正的錯誤

  • Add/Set-CMMsiDeploymentType -AddDetectionClause 失敗「運算式無效：運算元的資料類型不相符，或運算子對資料類型無效」。

非中斷性變更

  • 修改了資料類型初始化的邏輯，以確定當您指定 [存在] 參數時正確無誤。

New-CMOperatingSystemImageUpdateSchedule

非中斷性變更

  • 已新增新的參數，以符合在 UI 中建立排程精靈所做的變更：
    • -RemoveSupersededUpdates

New-CMOperatingSystemUpgradeUpdateSchedule

非中斷性變更

  • 已新增新的參數，以符合在 UI 中建立排程精靈所做的變更：
    • -RemoveSupersededUpdates

New-CMPackageDeployment

已修正的錯誤

  • New-CMPackageDeployment有不一致的警告

非中斷性變更

  • 已修改 SlowNetwork 選項的預設行為，以與 UI 一致。

New-CMStatusFilterRule

已修正的錯誤

  • New-CMStatusFilterRule無法如預期般運作
  • 無法建立具有屬性「套件識別碼」的新狀態篩選規則。

非中斷性變更

  • 已針對屬性識別碼/值檢查新增更多條件，以在未指定 -PropertyID 的情況下解除封鎖案例。
  • 新增邏輯，以在來源為 'Client' 時允許使用者設定屬性識別碼 = 'Package ID'。

New-CMTaskSequenceDeployment

已修正的錯誤

  • 無法設定工作順序部署的到期時間
  • New-CMTaskSequenceDeployment，$result無法從這個 Cmdlet 取得 物件。

非中斷性變更

  • 已將別名 「DeploymentExpireDateTime」 新增至參數 -DeadlineDateTime，以與 Set- Cmdlet 一致。
  • 已移除 using 區塊，不應處置部署物件。

New-CMTaskSequenceMedia

非中斷性變更

  • 已新增新的參數，以符合新增至工作順序媒體建立 UI 的變更：
    • -TemporaryFolder (別名 「TemporaryDirectory」， 「StagingArea」)

New-CMTSStepRunPowerShellScript

重大變更

  • 新增的參數集：RunScriptFromSource、RunScriptFromPackage。
  • PackageID 和 PackageName 參數不再是必要參數，因為使用者也可以輸入新的參數 SourceScript

非中斷性變更

  • 已新增新的參數，以比對工作順序編輯器 UI 中執行 Power Shell 腳本步驟所做的變更：
    • -SourceCode
    • -WorkingDirectory
    • -OutputVariableName
    • -超時
    • -使用者
    • -密碼
    • -SuccessCodes

Remove-CMDeviceAffinityFromUser

已修正的錯誤

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName 需要同時使用 「-DeviceId/-DeviceName」。

非中斷性變更

  • 已新增 -DeviceID 和 -DeviceName 的參數檢查，使用者應該至少指定其中一個。

Set-CMActiveDirectoryForest

已修正的錯誤

  • 建立 Active Directory 樹系 - 使用者無法透過 Powershell 運作，只有在透過 GUI 建立時才能運作。

非中斷性變更

  • 在使用者設定認證之後，將帳戶匯入至通用帳戶。
  • 已新增新的參數 -Password 以使用密碼建立認證。

Set-CMApplicationDeployment

非中斷性變更

  • 已新增新的參數 ReplaceToastNotificationWithDialog (布林值) ，當用戶端電腦上有可用的必要軟體時，系統管理員可以指定是否要將快顯通知取代為對話方塊。 它是選擇性參數，預設為 false。

Set-CMClientSetting

非中斷性變更

  • 已新增新的參數 ReplaceToastNotificationWithDialog (布林值) ，系統管理員可以在機器需要重新開機時，指定是否要將快顯通知取代為對話方塊。 它是選擇性參數，預設為 false。

Set-CMClientSettingComputerRestart

非中斷性變更

  • 已新增新的參數 ReplaceToastNotificationWithDialog (布林值) ，系統管理員可以在機器需要重新開機時，指定是否要將快顯通知取代為對話方塊。 它是選擇性參數，預設為 false。

Set-CMComplianceRuleExistential

已修正的錯誤

  • Set-CMComplianceRuleExistential -Rule 無法設定規則值。
  • Set-CMComplianceRuleExistential -ExpectedValue 不允許設定為負數，若未選取參數 [-Existence Occurs]，則會成功設定。

非中斷性變更

  • 已修改 WarnIgnoredParameter 函式，以確定它會使用 silent='true' 參數呼叫 IsBoundParameterUsed，以避免子 Cmdlet 將基底參數覆寫為非公用參數時發生封鎖錯誤。
  • 已將預期結果的驗證移至一般位置。

Set-CMDiscoveryMethod

已修正的錯誤

  • Set-CMDiscoveryMethod沒有參數可設定探索帳戶。

非中斷性變更

  • 已新增參數 -UserName，以指定為 AD 系統/使用者探索新增 ADContainer 的探索帳戶。

Set-CMDistributionPoint

非中斷性變更

  • 已新增 「-EnableLedbat」 參數，以在 DP 上啟用/停用 LEDBAT

Set-CMDriver

已修正的錯誤

  • Set-CMDriver - 陣列的 SupportedPlatformName 將會失敗

非中斷性變更

  • 已修正 SupportPlatformName 參數的陣列值問題。
  • 已新增 SupportedPlatform 的新參數：-AddSupportedPlatformName;-RemoveSupportedPlatformName;-ClearSupportedPlatform

取代

  • 已被取代的參數：-SupportedPlatformName

Set-CMManagementPoint

重大變更

  • 修改參數驗證以配合 UI，新增程式碼以在啟用/停用雲端閘道時重設用戶端連線類型。 這是一項重大變更，因為我們會封鎖使用者在不使用 SSL 的情況下啟用雲端閘道 (-EnableCloudGateway) 。

已修正的錯誤

  • Set-CMManagementPoint -EnableCloudGateway，在第一次將 MP 設定為 HTTPS / EnableCloudGateway true 時，將 MP 設定為 HTTP 時，就不應該檢查 EnableCloudGateway。

Set-CMStatusFilterRule

已修正的錯誤

  • Set-CMStatusFilterRule無法設定套件識別碼

非中斷性變更

  • 允許使用者設定屬性而不再次指定來源，UI 的不同在於我們需要使用者同時指定 -PropertyID 和 -PropertyValue。
  • 已新增程式碼，以避免物件不存在時出現空白警告訊息。

Set-CMTSStepRunPowerShellScript

非中斷性變更

  • 已新增新的參數，以比對工作順序編輯器 UI 中執行 Power Shell 腳本步驟所做的變更：
    • -SourceCode
    • -WorkingDirectory
    • -OutputVariableName
    • -超時
    • -使用者
    • -密碼
    • -SuccessCodes

Set-CMWindowsFirewallPolicy

已修正的錯誤

  • Set/Remove-CMWindowsFirewallPolicy -InputObject 需要從 New-CMWindowsFirewallPolicy 輸入正確的類型。

非中斷性變更

  • 已更正類型驗證。