バージョン2107の Configuration Manager コマンドレットライブラリの変更
適用対象:Configuration Manager (Current Branch)
これらのリリースノートでは、バージョン2107の Configuration Manager コマンドレットライブラリに加えられた変更の概要を説明します。
注意
Configuration Manager current branch バージョン2103は、これらの変更のベースラインです。 詳細については、 バージョン2103の Configuration Manager コマンドレットライブラリの変更に関する説明を参照してください。
アプリ展開の種類の新しいコマンドレット
アプリケーション展開の種類のインストール動作を管理する
この一連の新しいコマンドレットは、アプリケーション展開の種類のインストールの動作に使用されます。 インストール動作の機能について詳しくは、「実行中の実行可能ファイルを確認する」をご覧ください。
Add-CMDeploymentTypeInstallBehavior
このコマンドレットを使用すると、指定した展開の種類に対して、アプリを正常にインストールするために閉じる必要がある実行可能ファイルを追加できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"
詳細については、「 CMDeploymentTypeInstallBehavior の追加」を参照してください。
Get-CMDeploymentTypeInstallBehavior
このコマンドレットを使用すると、指定した展開の種類から、アプリを正常にインストールするために閉じる必要がある実行可能ファイルの一覧を取得できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt
詳細については、「 Get CMDeploymentTypeInstallBehavior」を参照してください。
Remove-CMDeploymentTypeInstallBehavior
このコマンドレットを使用すると、指定した展開の種類から、アプリを正常にインストールするために閉じる必要がある実行可能ファイルを削除できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"
詳細については、「 Remove-CMDeploymentTypeInstallBehavior」を参照してください。
Set-CMDeploymentTypeInstallBehavior
このコマンドレットを使用すると、アプリを正常にインストールするために閉じる必要がある実行可能ファイルを変更できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"
詳細については、「 Set-CMDeploymentTypeInstallBehavior」を参照してください。
アプリケーション展開の種類のリターン コードを管理する
この一連の新しいコマンドレットは、アプリケーションの展開の種類のリターンコード用です。 全般的な情報については、「展開の種類のリターン コード」をご覧ください。
Add-CMDeploymentTypeReturnCode
このコマンドレットを使用すると、サポートされている展開の種類にリターン コードを追加できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"
詳細については、「 CMDeploymentTypeReturnCode」を参照してください。
Get-CMDeploymentTypeReturnCode
このコマンドレットを使用すると、指定した展開の種類からリターン コードの一覧を取得できます。
Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode
詳細については、「 CMDeploymentTypeReturnCode」を参照してください。
Remove-CMDeploymentTypeReturnCode
このコマンドレットを使用すると、指定した展開の種類からリターン コードを削除できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602
詳細については、「 CMDeploymentTypeReturnCode」を参照してください。
Set-CMDeploymentTypeReturnCode
このコマンドレットを使用すると、指定した展開の種類のリターン コードを変更できます。
$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"
詳細については、「 CMDeploymentTypeReturnCode」を参照してください。
その他の新しいコマンドレット
Get-CMClientSettingDeployment
このコマンドレットを使用すると、カスタム クライアント設定オブジェクトの展開を取得できます。 このオブジェクトは 、CMClientSettingDeployment の削除と共に使用できます。
クライアント設定の構成については、クライアント設定の構成方法に関するページを参照してください。
$clientSetting = Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment
詳細については、「 Get CMClientSettingDeployment」を参照してください。
Get-CMDeploymentTypeDetectionClause
このコマンドレットを使用して、指定した展開の種類から検出句を取得します。
このコマンドレットは、1 つのアプリから検出句を取得し、それを別のアプリに適用するために使用できます。次に例を示します。
$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi
Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1
詳細については、「 CMDeploymentTypeDetectionClause」を参照してください。
Get-CMPersistentUserSettingsGroup
このコマンドレットを使用すると、保存したサイト全体の設定の一覧を取得できます。 これらの設定は、さまざまなデバイスに反映されます。
たとえば、アクティブであるか無視した Configuration Manager コンソール通知です。
詳細については、「 CMPersistentUserSettingsGroup」を参照してください。
Get-CMSoftwareUpdateContentInfo
ソフトウェア更新プログラムのコンテンツ情報を取得するには、このコマンドレットを使用します。
$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]
詳細については、「 CMSoftwareUpdateContentInfo」を参照してください。
Remove-CMPersistentUserSettingsGroup
このコマンドレットを使用すると、サイト全体の設定をリセットできます。
たとえば、無視した Configuration Manager コンソール通知を復元できます。 このコマンドレットを実行し、Configuration Manager コンソールを再起動すると、利用可能なすべての通知が再度表示されます。
詳細については、「 CMPersistentUserSettingsGroup」を参照してください。
非推奨のコマンドレットと削除されたコマンドレット
展開を開始するための次のコマンドレットは非推奨とされており、将来のリリースで削除される可能性があります。
非推奨のコマンドレット | Replacement |
---|---|
Start-CMApplicationDeploymentSimulation | New-CMApplicationDeployment と Simulation パラメーター |
Start-CMClientSettingDeployment | New-CMClientSettingDeployment |
Start-CMAntimalwarePolicyDeployment | New-CMAntimalwarePolicyDeployment |
次のコマンドレットは、基礎となる機能がサポートされなくなったため、使用できなくなりました。
Add-CMApplicationCatalogWebServicePoint
Add-CMApplicationCatalogWebsitePoint
Get-CMApplicationCatalogWebServicePoint
Get-CMApplicationCatalogWebsitePoint
Remove-CMApplicationCatalogWebServicePoint
Remove-CMApplicationCatalogWebsitePoint
Set-CMApplicationCatalogWebsitePoint
Get-CMVhd
New-CMVhd
Remove-CMVhd
Set-CMVhd
コマンドレットの変更
このバージョンの既存のコマンドレットには、次の変更が加えられました。 変更は、新しい機能またはバグ修正の可能性があります。 一部の変更が中断している可能性があります。 このセクションに記載されているコマンドレットまたは機能領域のいずれかを使用する場合は、変更内容を慎重に確認して、使用にどのように影響するかを理解してください。
Add-CMDeviceCollectionDirectMembershipRule
詳細については、「Add-CMDeviceCollectionDirectMembershipRule」を参照してください。
修正されたバグ
ダイレクト メンバーシップの規則として数千のデバイスを追加しようとするときの問題を修正しました。
Add-CMDistributionPoint
詳細については、「Add-CMDistributionPoint」を参照してください。
重大な変更
既定の最小空き領域は、50 MB から 500 mb に変更されました。
Add-CMTaskSequenceStep
詳細については、「Add-CMTaskSequenceStep」を参照してください。
非破壊的変更
不要なパラメーター StepName を削除しました。
Disconnect-CMTrackedObject
詳細については、「Disconnect-CMTrackedObject」を参照してください。
非破壊的変更
このコマンドレットに別名 Disconnect-CMObject を追加しました。
Get-CMApplicationGroup
詳細については、「 Get CMApplicationGroup」を参照してください。
修正されたバグ
正しいアプリ グループ パスを取得するための問題を修正しました。
Get-CMDeploymentStatusDetails
詳細については、「 Get CMDeploymentStatusDetails」を参照してください。
修正されたバグ
型の不一致の可能性を回避するために、クエリ条件を修正します。
Import-CMAntimalwarePolicy
詳細については、「 CMAntimalwarePolicy」を参照してください。
非破壊的変更
望ましくない可能性のあるアプリケーションを含む監査モードポリシーのサポートが追加されました。 詳細については、「 望ましくない可能性のあるアプリケーションの監査モード」を参照してください。
Import-CMQuery
詳細については、「 インポート-CMQuery」を参照してください。
修正されたバグ
Import 関数のブロックを解除する問題を修正しました。
New-CMAdministrativeUser
詳細については、「 CMAdministrativeUser」を参照してください。
修正されたバグ
ユーザー名がの場合の問題を修正 me
します。
New-CMApplicationDeployment
詳細については、「 New-CMApplicationDeployment」を参照してください。
非破壊的変更
Autocloseexecutable パラメーターを追加して、インストール動作のアプリケーション展開設定を有効にしました。
New-CMCloudManagementGateway
詳細については、「New-CMCloudManagementGateway」を参照してください。
重大な変更
ServiceCertPassword パラメーターが必須になりました。
New-CMMigrationJob
詳細については、「 CMMigrationJob」を参照してください。
修正されたバグ
ソフトウェア配布展開オブジェクトの移行のブロックが解除されました。
New-CMSecondarySite
詳細については、「 New-CMSecondarySite」を参照してください。
重大な変更
既定の最小空き領域が 200 MB から 500 mb に変更されました。
New-CMSoftwareUpdateAutoDeploymentRule
詳細については、「New-CMSoftwareUpdateAutoDeploymentRule」を参照してください。
修正されたバグ
Product パラメーターの問題を修正しています。 同じ名前の複数の製品がある場合は、すべての製品が選択されます。
New-CMSoftwareUpdateDeployment
詳細については、「 New-Cmソフトウェア Updatedeployment」を参照してください。
非破壊的変更
Comment パラメーターに Description のエイリアスを追加しました。
New-CMTaskSequence
詳細については、「New-CMTaskSequence」を参照してください。
非破壊的変更
Description パラメーターの最大長は
512
文字に拡張されました。パフォーマンス設定をサポートするための新しいパラメーター HighPerformance が追加されました。
レガシ パラメーターの InstallationLicensingMode は削除されました。
新しい パラメーターセットを削除しました。
Inst合金の Systemimagevhd パラメーターが削除されました。
New-CMTaskSequenceDeployment
詳細については、「 New-CMTaskSequenceDeployment」を参照してください。
修正されたバグ
高パフォーマンスの電源プランの問題を修正しています。
New-CMTSStepApplyDriverPackage
詳細については、「 New-CMTSStepApplyDriverPackage」を参照してください。
非破壊的変更
指定された PackageId のパッケージを検証する条件を追加しました。
New-CMTSStepApplyOperatingSystem
詳しくは、「CMTSStepApplyOperatingSystem」をご覧ください。
修正されたバグ
DestinationVariable パラメーターの検証の問題が修正され、アンダースコア (_
) で始まる値が許可されるようになりました。
非破壊的変更
OS の展開時にレイヤー化キーボードドライバーをサポートするために、レイヤー eddriver パラメーターが追加されました。
New-CMTSStepUpgradeOperatingSystem
詳細については、「 CMTSStepUpgradeOperatingSystem」を参照してください。
非破壊的変更
OS のアップグレードタスク シーケンス ステップの機能更新プログラムを指定する新しいパラメーター SoftwareUpdate が追加されました。
Publish-CMPrestageContent
詳細については、「 publish-cmprestagecontent は」を参照してください。
修正されたバグ
無効なオブジェクトの潜在的な問題を修正した。
Remove-CMApplicationGroup
詳細については、「 CMApplicationGroup の削除」を参照してください。
修正されたバグ
パイプラインを使用するときに適切なアプリ グループ パスを取得するための問題を修正しました。
Set-CMAntimalwarePolicy
詳細については、「 CMAntimalwarePolicy」を参照してください。
非破壊的変更
望ましくない可能性のあるアプリケーションをサポートするためのパラメーター Puaprotection を追加しました。
Set-CMApplicationDeployment
詳細については、「 Set-CMApplicationDeployment」を参照してください。
非破壊的変更
Autocloseexecutable パラメーターを追加して、インストール動作のアプリケーション展開設定を有効にしました。
Set-CMClientSetting
詳細については、「 CMClientSetting の設定」を参照してください。
非破壊的変更
SoftwareMetering パラメーターのわかりやすい非推奨化メッセージが追加されました。
Set-CMClientSettingSoftwareUpdate
詳細については、「 Cmclientsettingソフトウェア更新プログラムの設定」を参照してください。
非破壊的変更
証明書のピン留めをサポートするためのパラメーター EnableWsusCertPinning を追加しました。
Set-CMDeploymentType
詳細については、「Set-CMDeploymentType」を参照してください。
修正されたバグ
AddRequirement パラメーターに関する問題を修正し、新しい規則を追加しました。
Set-CMMsiDeploymentType
詳細については 、「Set-CMMsiDeploymentType 」を参照してください。
修正されたバグ
コンテンツの場所を変更するときに構成がリセットされないように、インストーラーの種類に応じて展開の種類を更新します。
非破壊的変更
ContentLocation パラメーターにフォルダー パスを指定するためのサポートを追加します。
Set-CMTaskSequence
詳細については 、「Set-CMTaskSequence 」を参照してください。
非破壊的変更
タスク シーケンスのパフォーマンス設定をサポートする新しいパラメーター HighPerformance を追加しました。
Set-CMTSStepApplyDriverPackage
詳細については 、「Set-CMTSStepApplyDriverPackage 」を参照してください。
非破壊的変更
指定した PackageId のパッケージを検証する条件を 追加しました。
Set-CMTSStepApplyOperatingSystem
詳細については 、「Set-CMTSStepApplyOperatingSystem 」を参照してください。
修正されたバグ
Destination パラメーターに関する 問題を修正 しました。
非破壊的変更
OS の展開 中にレイヤー化された キーボード ドライバーをサポートするために LayeredDriver パラメーターを追加しました。
Set-CMTSStepUpgradeOperatingSystem
詳細については 、「Set-CMTSStepUpgradeOperatingSystem 」を参照してください。
非破壊的変更
OS のアップグレードタスク シーケンス ステップの機能更新プログラムを指定する新しいパラメーター SoftwareUpdate が追加されました。
Start-CMDistributionPointUpgrade
詳細については 、「Start-CMDistributionPointUpgrade 」を参照してください。
重大な変更
既定の最小空き領域を 500 MB に設定します。
Update-CMDistributionPoint
詳細については、「Update-CMDistributionPoint」を参照してください。
修正されたバグ
インストール フォルダーとアンインストール フォルダーが異なる場合に、両方のコンテンツを更新する問題を修正しました。
フィードバックを提供する方法または問題を報告する方法
この記事で説明する修正と機能強化の多くは、フィードバックの結果です。
フィードバックを送信するには、コンソールで 構成マネージャーします。 詳細については 、「PowerShell のフィードバック」を参照してください。
新しい機能要求を送信するには 、UserVoiceの PowerShell 構成マネージャーを参照してください。