次の方法で共有

Current Branch 1710 のConfiguration Manager コマンドレット ライブラリの変更

  • [アーティクル]

注:

System Center Configuration Current Branch 1706 は、これらの変更のベースラインです。 詳細については、「Current Branch 1706 のコマンドレット ライブラリの変更をConfiguration Managerする」を参照してください。

重要な変更

ドキュメント ライブラリの更新

最新のコマンドレット ライブラリのドキュメントについては、「 ConfigurationManager モジュール リファレンス」を参照してください。

削除されたコマンドレット

次のコマンドレットはサポートされなくなり、削除されました。

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

非推奨のコマンドレット

  • Invoke-CMEndpointProtectionScan と Save-CMEndpointProtectionDefinition が置き換えられます Invoke-CMClientAction。

PSDrive の自動作成を無効にする

ConfigurationManager.psd1 モジュールが読み込まれると、PowerShell は、Configuration Manager コンソールを使用してアクセスされた最後の SMS プロバイダーへの接続を自動的に作成しようとします。 シナリオによっては、この動作が望ましくない場合があります。 この動作を無効にし、手動でドライブを作成する必要があるユーザーごとのレジストリ キーが追加されました。 これを構成するには、レジストリ キーを使用し、 HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell 値 DisableCMDriveAutoCreate を DWORD の 1 (ドライブの自動作成が無効) または 0 (既定の動作) に設定します。 削除すると、既定の DisableCMDriveAutoCreate 動作も有効になります。

注:

ドライブの自動作成が無効になっている場合、powerShell ウィンドウを起動すると、Configuration Manager コンソールでエラーが報告される場合があります。

既知の問題

これらは、このリリースでは解決されないコマンドレット ライブラリに関する既知の問題です。

Get-CMAadConditionalAccessPolicyとSet-CMAadConditionalAccessPolicy

これらのコマンドレットには、64 ビットの PowerShell 環境が必要です。

回避策

  • None

Import-CMSecurityRole

コマンドレットは、ファイル SecuredRoles.xsdを検索する DirectoryNotFoundException エラーで失敗する可能性があります。

回避策

論理 Import-Module パスまたはモジュール名ではなく、 がファイルに対して ConfigurationManager.psd1 呼び出されていることを確認します。

Get-CMSiteUpdateInstallStatus

コマンドレットが WqlQueryException エラーで失敗する可能性があります。

回避策

  • Invoke-CMWmiQueryを使用して、SMS_CM_UpdatePackTopLevelMonitoring クラスに直接クエリを実行します。
例
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

基になる SMS Provider オブジェクトが変更されていても、Schedule への変更はConfiguration Managerコンソールに反映されない場合があります。

回避策

Configuration Manager コンソールを終了して再起動します。

新しいコマンドレット

これらは、新しい機能を追加したり、既存のコマンドレットの機能を強化したりする、このリリース用に新しく追加されたコマンドレットです。

デバイス関連付けコマンドレット

Get-CMResultantCollection は、デバイスに関連付けられているコレクションを取得します。 Get-CMResultantDeployment は、デバイスを対象とするデプロイを取得します。

クライアント インベントリ クラスの管理

クライアント インベントリに使用されるインベントリ クラスの変更をサポートするために、新しいコマンドレットが追加されました。

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

タスク シーケンス

タスク シーケンスの手順の変更をサポートするために、新しいコマンドレットが追加されました。

  • タスク シーケンス コマンド (Get、New、Remove、Set verbs supported)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

リソースの追跡と回復 (BETA)

PowerShell ランタイムで使用される SMS プロバイダー オブジェクトの追跡をサポートし、不要になったリソースをクリーンアップするために、新しいコマンドレットが追加されました。

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

を実行すると Start-CMObjectTracking 、PowerShell ランタイムはコマンドレット ライブラリ コマンドレットによって作成されたオブジェクトを追跡 IResultObject します。 手動でクリーンアップ .Dispose() されないコマンドレットは、個々のオブジェクトに対して を使用 Disconnect-CMTrackedObject して再利用できます。

例

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

オブジェクトが再利用されると、オブジェクト パイプラインを介して再利用したり、別のコマンドレットに渡したりできなくなります。

Stop-CMObjectTracking を使用して、オブジェクトの追跡をオフにすることができます。 以前に割り当てられたオブジェクトはアクティブなままになります。

リソースが解放されていないと、SMS プロバイダーによってクォータ違反エラーが発生する可能性があります。 通常、これらの問題は、非常に大規模な SMS プロバイダー オブジェクトのセットを操作するか、非常に長時間実行される環境で動作する場合に現れます

注:

これは実験的な機能であり、将来のリリースで変更または削除される可能性があります。 この機能はオプトインであり、既定では有効になっていません。

コマンドレットの変更

このリリースの既存のコマンドレットに対して、次の変更が行われました。 変更は、新機能、バグ修正、または非推奨の可能性があり、破壊的な可能性があります。 このセクションに記載されているコマンドレットまたは機能領域のいずれかを使用する場合は、変更内容を注意深く確認して、使用に与える影響を理解してください。

コンプライアンス設定とルール コマンドレット

修正されたバグ

RuleDescription 値が Rule に適用されない場合があります。 (ルールの作成または変更をサポートするコマンドレット)

"default" レジストリ キーの値を設定できません (Add/Set-CMComplianceSettingRegistryKeyValue、New-CMDetectionClauseRegistryKeyValue)。

NullReferenceException が発生する可能性があります (New-CMComplianceRuleAssembly)

DataType のサポートがありません (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

修正されたバグ

エラー処理とレポートの改善。

Add/Set-CMDataWarehouseServicePoint

破壊的でない変更

DataWarehouseSqlPort では 、1 から 65535 のポート値がサポートされます。 DaysOfWeek パラメーターで、 の Daily値がサポートされるようになりました。

Add/Set-CMExchangeServer

修正されたバグ

EmailAddress パラメーター値は、Exchange サーバー構成に適用されない場合があります。

Add-CMMsiDeploymentType

修正されたバグ

スクリプト検出を使用する場合は、ContentLocation パラメーターが必要です。 新しい UninstallContentLocation パラメーターと UninstallOption パラメーターが 追加されました。

破壊的でない変更

ProductCode パラメーターの検証が強化されました。

Add-CMScriptDeploymentType

破壊的でない変更

ProductCode パラメーターの検証が強化されました。 新しい UninstallContentLocation パラメーターと UninstallOption パラメーターが 追加されました。

Get-CMDeploymentTypeDependencyGroup

破壊的でない変更

コマンドレットで、 からの Get-CMDeploymentTypeパイプライン値がサポートされるようになりました。

Get-CMSiteStatusMessage

修正されたバグ

Severity パラメーターを使用してフィルター処理するときに、すべてのメッセージが返されるわけではありません。

Invoke-CMClientAction (旧称 Invoke-CMClientNotification)

破壊的でない変更

すべてのクライアント通知の種類を受け入れる ActionType パラメーター。

注:

RequestScriptExecution 現時点ではサポートされていません。

非推奨

NotificationType が ActionType に置き換えられた

New-CM*Deployment

修正されたバグ

コマンドレットを使用すると、 CollectionId、 CollectionName、および Collection パラメーターを組み合わせることができ、未定義の動作につながる可能性があります。

New-CMBootableMedia

修正されたバグ

SiteBased としてメディアを作成できません。

New-CMWirelessProfile

修正されたバグ

コマンドレットは、64 ビット PowerShell 環境で実行できません。

ClientCertificate パラメーターの値を指定すると、コマンドレットからエラーが返されることがあります。

Remove-CMCorpOwnedDevice

修正されたバグ

パイプライン オブジェクトを使用している場合、デバイスを削除できません。

WhatIf または Confirm を使用している場合、デバイス名は報告されません。

Remove-CMStateMigrationPoint

破壊的変更

状態移行ポイントに格納されているユーザー データがある場合は、追加の確認が必要です。 注: この 確認は強制的にバイパスされます。

Save-CMSoftwareUpdate

破壊的でない変更

失敗後にダウンロードを再試行するために、 RetryCount パラメーターと RetryDelaySec パラメーターを追加しました。

Set-CMAccessAccount

修正されたバグ

PassThru は、更新されたオブジェクトを返さない場合があります。

Set-CMAntimalwarePolicy

修正されたバグ

AddExcludedFilePath パラメーターでワイルドカード文字を使用することはできません。

特定のポリシーに対して構成 FallbackOrder できない

破壊的でない変更

脅威リストを管理するための新しいパラメーター ( AddThreat、 RemoveThreat、 CleanThreat) が追加されました。 AddThreat は、キーが名前で、値が 型 Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowTypeであるハッシュテーブルを受け入れます。

非推奨

ThreatName パラメーターと OverrideAction パラメーターは 、AddThreat、 RemoveThreat、 CleanThreat に置き換えられます。

Set-CMClientSettingComputerAgent

非推奨

HealthAttestationUrl パラメーターは、製品によって使用されなくなりました。

Set-CMClientSettingHardwareInventory

破壊的でない変更

AddInventoryReportClass、 CleanInventoryReportClass、 および RemoveInventoryReportClass パラメーターは、クライアントによって収集されるハードウェア インベントリの変更をサポートします。

Set-CMMsiDeploymentType

破壊的でない変更

ProductCode パラメーターの検証が強化されました。

Set-CMScriptDeployment

修正されたバグ

SMS Provider のアプリケーション オブジェクトは、コマンドレットが失敗した場合、ロックの有効期限が切れるまでさらに変更を行わないと、自動的にロック解除されない場合があります。

Set-CMScriptDeploymentType

破壊的でない変更

ProductCode パラメーターの検証が強化されました。

Set-CMSoftwareUpdatePointComponent

破壊的でない変更

更新プログラムのダウンロード動作を構成するための新しい ContentFileOption パラメーターを追加しました。

Set-CMSiteMaintenanceTask

破壊的でない変更

エラー報告の改善

Set-CMWirelessProfile

修正されたバグ

コマンドレットは、64 ビット PowerShell 環境で実行できません。

オブジェクト パイプラインを使用すると、不一致PSTypeName エラーが発生する可能性があります。

ProxyAddress と ProxyPort は、Configuration Manager コンソールと同じ規則を使用して検証しません。

ProxyPort なしで ProxyAddress を指定すると、無効な構成が作成される可能性があります。

SecurityAuthentication は、これをサポートしていない構成で変更できます。

EapType は、後者が変更されていない場合でも 、SecurityAuthentication と組み合わせる必要があります。

破壊的でない変更

RootCertificate、ClientCertificate、RememberCredentials の各パラメーターを追加しました。

MSCHAPv2 ワイヤレス ポリシーを構成するための機能が強化されました。

Sync-CMSoftwareUpdate

破壊的でない変更

コマンドレットでパラメーターを指定する必要がなくなりました。

注:

パラメーターが定義されていない場合は、 -ForceSync $true 暗黙的に指定されます。