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

Configuration Manager (現在のブランチ) に適用

これらのリリース ノートは、バージョン 2103 のConfiguration Manager コマンドレット ライブラリの変更点をまとめたものです。

注:

Configuration Manager現在のブランチ バージョン 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 バージョン 7 セッションでこれらのコマンドレットを使用しようとすると、次のエラーで失敗します。 This cmdlet only supports the ".NET Framework" runtime.

新しいコマンドレット

コマンドレットの変更

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

高速サポート

次のコマンドレットで 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

破壊的でない変更

パラメーター ManagementCategory でフィルター処理する機能を追加しました。

$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 を追加しました。 このパラメーターを追加すると、サイトはマルチインデックス イメージから 1 つのインデックス イメージを抽出します。 次に、元のイメージと同じソース フォルダーに新しいイメージを配置します。

New-CMOperatingSystemInstaller

破壊的でない変更

パラメーター Index を追加しました。 このパラメーターを追加すると、サイトは現在のマルチインデックス イメージを新しい単一のインデックス イメージに置き換えます。

New-CMTSRule

破壊的でない変更

Parameter ReferencedVariableOperator には、 NotLikeという別の値があります。

New-CMTSStepConditionVariable

破壊的でない変更

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

New-CMSoftwareUpdateAutoDeploymentRule

破壊的変更

パラメーター O365LanguageSelection の問題を修正しました。 ここで、国/地域名を持つ言語を指定する必要があります。 この変更により、このパラメーターは、Configuration Manager コンソールのオプションに合わせて調整されます。 たとえば、-O365LanguageSelection "English (米国)" のように指定します。

Set-CMCertificateProfileScep

修正されたバグ

パラメーター SanType の問題を修正しました。

Set-CMClientPushInstallation

破壊的でない変更

パラメーター AllownNTLMFallback を追加して NTLM フォールバックを有効にします。

Set-CMCollection

破壊的でない変更

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

Set-CMEmailProfile

破壊的でない変更

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

Set-CMFallbackStatusPoint

破壊的でない変更

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

Set-CMThirdPartyUpdateCatalog

破壊的でない変更

パラメーター CategoryNamePublishOptionCategoryIdPublishOption を追加します。 これらのパラメーターを使用して、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

破壊的でない変更

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

Set-CMTSStep*

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

破壊的でない変更

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

Set-CMSoftwareUpdateAutoDeploymentRule

破壊的変更

パラメーター O365LanguageSelection の問題を修正しました。 ここで、国名を持つ言語を指定する必要があります。 この変更により、このパラメーターは、Configuration Manager コンソールのオプションに合わせて調整されます。 たとえば、-O365LanguageSelection "English (米国)" のように指定します。

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

この記事で説明されている修正プログラムと機能強化の多くは、フィードバックの結果です。

フィードバックを送信するには、Configuration Manager コンソールを使用します。 詳細については、「 PowerShell のフィードバック」を参照してください。