バージョン2103の Configuration Manager コマンドレットライブラリの変更

  • [アーティクル]

適用対象:Configuration Manager (Current Branch)

これらのリリースノートでは、バージョン2103の Configuration Manager コマンドレットライブラリに加えられた変更の概要を説明します。

注意

Configuration Manager current branch バージョン2010は、これらの変更のベースラインです。 詳細については、 バージョン2010の Configuration Manager コマンドレットライブラリの変更に関する説明を参照してください。

更新可能な PowerShell ヘルプに関する既知の問題

バージョン 2010 以降は、Update-Help コマンドレットを使用して Configuration Manager PowerShell モジュールの最新情報をダウンロードできます。

バージョン2103では、PowerShell モジュールの構造は29の Dll から2に変更されました。 PowerShell XML ヘルプファイルは、コマンドレットの DLL に関連付けられています。 バージョン2010ヘルプコンテンツはバージョン2103コンソールと互換性がなく、バージョン2103ヘルプコンテンツはバージョン2010コンソールと互換性がありません。

更新可能なコンテンツを構築し、バージョン2103のリリースで公開する方法がこのように変更されたため、バージョン2010サイトでは update-help を使用しないでください。 サイトをバージョン 2103 に更新してから、ローカル ヘルプ コンテンツを更新します。

コンテンツは、コマンドレットによってバージョン 2010 のコンソールに正常にダウンロードされますが、Get-Help からは既定の使用情報のみが返されます。 これは、PowerShell がコマンドレットの情報を適切な XML ファイルで見つけることができないためです。 バージョン 2103 のリリース前に、バージョン 2010 サイトで Update-Help を使用していた場合は、Get-Help を使用し続けることができるようになりました。

同様に、バージョン2010のサイトで update-help を使用した場合は、バージョン2103に更新した後で 、update-help を再度実行 して、互換性のあるバージョンのヘルプコンテンツを取得します。 それ以外 の場合、get-help は既定の使用情報のみを返します。

注意

この問題は、バージョン2010に固有のものです。 構造がどのように変更されたかにより、以降のバージョンでは問題にならないようにしてください。

PowerShell モジュール

デバイス上の Configuration Manager コンソールがまだサイトに接続されていない場合、ConfigurationManager モジュールを手動でインポートすると、既定の SMS プロバイダーに基づいてサイト用の PowerShell ドライブが作成されます。

バージョン2103以降では、ConfigurationManager PowerShell モジュールには Microsoft .NET バージョン4.7.2 以降が必要です。

PowerShell バージョン 7 がサポートされないコマンドレット

Configuration Manager のコマンドレットでは、PowerShell バージョン 7 が一般的にサポートされていますが、次のコマンドレットでは PowerShell 7 はサポートされていません。

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

これらでは、PowerShell バージョン 7 で使用される .NET Core ではなく、.NET Framework が必要です。

バージョン2103以降では、PowerShell version 7 セッションでこれらのコマンドレットを使用しようとすると、次のエラーで失敗します。 This cmdlet only supports the ".NET Framework" runtime.

新しいコマンドレット

コマンドレットの変更

このバージョンの既存のコマンドレットには、次の変更が加えられました。 変更は、新しい機能、バグの修正、または廃止される可能性があります。 一部の変更が中断している可能性があります。 このセクションに記載されているコマンドレットまたは機能領域のいずれかを使用する場合は、変更内容を慎重に確認して、使用にどのように影響するかを理解してください。

Fast のサポート

次のコマンドレットでは、Fast パラメーターがサポートされるようになりました。 このパラメーターを使用すると、表示に時間のかかるプロパティが自動的に更新されなくなります。 表示に時間のかかるプロパティには、効率よく取得できない値が含まれています。 これらのプロパティを取得すると、ネットワーク トラフィックが増加し、コマンドレットのパフォーマンスに影響する可能性があります。

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

非破壊的変更

一貫性のないパラメーター名を修正しました。

Copy-CMCollection

非破壊的変更

コンソールに合わせ、NewName パラメーターを使用した検証が修正されました。

Get-CMDeploymentStatusDetails

非破壊的変更

  • SMS_DCMDeploymentErrorStatus、SMS_DCMDeploymentNonCompliantStatus、SMS_DCMDeploymentCompliantStatus などの型に対する入力オブジェクト型の検証の問題を修正しました。
  • 出力オブジェクトの型 SMS_AppDeploymentRequirementsNotMetStatus を SMS_AppDeploymentRequirementsNotMetAssetDetails に変更することにより、無効なクラス型が出力される問題を修正しました。
  • いっそう詳細なエラーを取得できるように、出力オブジェクトの型を SMS_AppDeploymentAssetDetails から SMS_AppDeploymentErrorAssetDetails に変更しました。
  • このコマンドレットで更新プログラムのデプロイの詳細を取得できるように、入力オブジェクトの型 SMS_UpdateDeploymentSummary を追加しました。 Get-CMSoftwareUpdateDeploymentStatus の出力を Get-CMDeploymentStatusDetails に渡すと、SMS_SUMDeploymentAssetDetails からデプロイの詳細が返されます。

Get-CMDriver

非破壊的変更

パラメーター AdministrativeCategory でフィルター処理できるようになりました。

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

非破壊的変更

特定のパッケージの種類を取得するためのパラメーター Packagetype を追加しました。

Get-CMSoftwareUpdateDeployment

非破壊的変更

パッケージを使用しないで更新プログラムをデプロイするときの問題を修正しました。

New-CMApplication

修正されたバグ

"yyyy/MM/dd" という時刻形式で作成されたアプリをインストールするときのソフトウェア センターの表示に関する問題を修正しました。

New-CMCertificateProfileScep

修正されたバグ

パラメーター SanType に関する問題を修正しました。

New-CMCollection

非破壊的変更

コンソールに合わせ、Name パラメーターを使用した検証が修正されました。

New-CMOperatingSystemImage

非破壊的変更

パラメーター Index を追加しました。 このパラメーターを追加すると、サイトによって複数インデックスのイメージから単一インデックスのイメージが抽出されます。 その後、新しいイメージは元のイメージと同じソース フォルダーに配置されます。

New-CMOperatingSystemInstaller

非破壊的変更

パラメーター Index を追加しました。 このパラメーターを追加すると、サイトによって現在の複数インデックスのイメージが新しい単一インデックスのイメージに置き換えられます。

New-CMTSRule

非破壊的変更

パラメーター ReferencedVariableOperator には、別の 可能な値があります NotLike 。

New-CMTSStepConditionVariable

非破壊的変更

Parameter OperatorType には、 別の可能な値があります。 NotLike

New-CMSoftwareUpdateAutoDeploymentRule

重大な変更

パラメーター O365LanguageSelection に関する問題を修正しました。 国名と共に言語を指定することが必要になりました。 この変更により、このパラメーターが Configuration Manager コンソールのオプションと一致するようになります。 たとえば、-O365LanguageSelection "English (United States)" のように指定します。

Set-CMCertificateProfileScep

修正されたバグ

パラメーター SanType に関する問題を修正しました。

Set-CMClientPushInstallation

非破壊的変更

パラメーター AllownNTLMFallback が追加され、NTLM フォールバックが有効になりました。

Set-CMCollection

非破壊的変更

コンソールに合わせ、NewName パラメーターを使用した検証が修正されました。

Set-CMEmailProfile

非破壊的変更

  • アカウントのユーザー名として sAMAccountName を指定するときの、NewName パラメーターに関する問題を修正しました。
  • DomainName を解決するときの、パラメーターの問題を修正しました。

Set-CMFallbackStatusPoint

非破壊的変更

一貫性のないパラメーター名を修正しました。

Set-CMThirdPartyUpdateCatalog

非破壊的変更

CategoryNamePublishOption と CategoryIdPublishOption パラメーターが追加されました。 これらのパラメーターでは、v3 カタログにサブスクライブするときに、カテゴリの発行オプションを設定できます。

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

非破壊的変更

FullContent に設定された PublishOption パラメーターの問題が修正されました。

Set-CMTSStep*

たとえば、Set-CMTSStepApplyDataImage、およびその他 34 個の同様のコマンドレットです。

非破壊的変更

Parameter OperatorType には、 別の可能な値があります。 NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

重大な変更

パラメーター O365LanguageSelection に関する問題を修正しました。 国名と共に言語を指定することが必要になりました。 この変更により、このパラメーターが Configuration Manager コンソールのオプションと一致するようになります。 たとえば、-O365LanguageSelection "English (United States)" のように指定します。

フィードバックを提供する方法または問題を報告する方法

この記事で説明する修正と機能強化の多くは、フィードバックの結果です。

フィードバックを送信するには、コンソールで 構成マネージャーします。 詳細については 、「PowerShell のフィードバック」を参照してください。

新しい機能要求を送信するには 、UserVoiceの PowerShell 構成マネージャーを参照してください。