Current Branch 1610 のコマンドレット ライブラリの変更をConfiguration Managerする
注意
Configuration Manager コマンドレット ライブラリの 1604 バージョンは、これらの変更のベースラインです。
重要な変更
管理者コンソールを使用すると、統合スクリプト環境 (ISE) を起動できます
管理者コンソールから、ISE を起動するための追加オプションが追加されました:"Windows PowerShell ISE 経由で接続する" というオプションが追加されました。
コマンドレットの更新チェック
コマンドレット ライブラリは、更新されたバージョンを確認しなくなります。 コマンドレット ライブラリは現在、Configuration Manager リリースと同時に出荷されるため、このチェックは不要になりました。
Get-CM* コマンドレットは"高速" モードをサポートする場合があり、使用されていない場合は警告を返す可能性があります
Get コマンドレットの一部に Fast パラメーターが追加されました。 このパラメーターを使用すると、コマンドレットは、遅延プロパティを自動的に更新せずにオブジェクトを返すことができます。 遅延プロパティ値を取得すると、追加のネットワーク トラフィックが発生し、コマンドレットの実行が遅くなる可能性があります。 遅延プロパティを使用しない場合は、コマンドレット パラメーターとして Fast を指定する必要があります。
この変更を可視化するために、 Fast をサポートするコマンドレットは、その存在が有益な場合に使用されない場合に、コンソールに警告を書き込みます。 この警告は、設定 $CMPSSuppressFastNotUsedCheck = $True
することで抑制できます。
フィードバックまたはレポートの問題を提供する方法
このドキュメントで説明する修正と機能強化の多くは、お客様からのフィードバックの結果です。 詳細については、「 製品のフィードバック」を参照してください。
既知の問題
これらは、このリリースでは解決されないコマンドレット ライブラリに関する既知の問題です。
論理名を使用して ConfigurationManager.psd1 モジュールをインポートできない
ConfigurationManager.psd1 モジュールへのパスが PSMODULEPATH 環境変数に追加されている場合は、Import-Module ConfigurationManager を使用してインポートできません。
回避策
モジュールへの完全なパスを使用する
https://gallery.technet.microsoft.com/Make-Configuration-Manager-04474a87
注意
この回避策は、ユーザー コミュニティによって提供され、Microsoft によってテストまたはサポートされていません。
Add-CMEnrollmentProxyPoint
プライマリ サイトに複数の登録ポイントがある場合、または登録ポイントが別のサーバー上にある場合、コマンドレットによって登録プロキシ ポイントが正しく構成されない場合があります。
回避策
- この構成には、管理者コンソールを使用します。
Get-CMAadConditionalAccessPolicy/Set-CMAadConditionalAccessPolicy
これらのコマンドレットには、64 ビットの PowerShell 環境が必要です。
回避策
- None
新しいコマンドレット
これらは、新しい機能を追加したり、既存のコマンドレットの機能を強化したりする、このリリース用に新しく追加されたコマンドレットです。
クライアントの設定
クライアント設定の変更に関するエクスペリエンスを向上させるために、新しいコマンドレットが作成されました。 これらのコマンドレットは Set-CMClientSetting コマンドレットに置き換えられます。これは非推奨になりました。 これらのコマンドレットは、 Get-CMClientSetting コマンドレットのオブジェクト パイプラインを使用して、ユーザー定義のクライアント設定を変更することをサポートします。
- Set-CMClientSettingBackgroundIntelligentTransfer
- Set-CMClientSettingClientCache
- Set-CMClientSettingClientPolicy
- Set-CMClientSettingCloudService
- Set-CMClientSettingComplianceSetting
- Set-CMClientSettingComputerAgent
- Set-CMClientSettingComputerRestart
- Set-CMClientSettingEndpointProtection
- Set-CMClientSettingEnrollment
- Set-CMClientSettingGeneral
- Set-CMClientSettingHardwareInventory
- Set-CMClientSettingMeteredInternetConnection
- Set-CMClientSettingPowerManagement
- Set-CMClientSettingRemoteTool
- Set-CMClientSettingSoftwareDeployment
- Set-CMClientSettingSoftwareInventory
- Set-CMClientSettingSoftwareMetering
- Set-CMClientSettingSoftwareUpdate
- Set-CMClientSettingStateMessaging
- Set-CMClientSettingUserAndDeviceAffinity
条件付きアクセス ポリシー
Azure Active Directory (Azure AD) の条件付きアクセス ポリシー設定をサポートする新しいコマンドレットが作成されました。
- Get-CMAadConditionalAccessPolicy
- Set-CMAadConditionalAccessPolicy
例
PR1:\> Get-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -UserCredential (Get-Credential)
PR1:\> Set-CMAadConditionalAccessPolicy -AccountId 752c1e46-ddd2-4ffc-8f15-23623328c823 -ServicePrincipalType ExchangeOnline -Enabled $true -TargetedDevicePlatforms Windows,WindowsPhone -WindowsDeviceState Compliant -IncludedSecurityGroup All_Users -UserCredential (Get-Credential)
Copy-CMCollection
このコマンドレットは、既存のコレクションを新しいコレクションに複製するために使用できます。
Endpoint Protection
高度な脅威保護ポリシー管理用の新しいコマンドレット:
- Get-CMAdvancedThreatProtectionPolicy
- New-CMAdvancedThreatProtectionPolicy
- Remove-CMAdvancedThreatProtectionPolicy
- Set-CMAdvancedThreatProtectionPolicy
Get/Set-CMSiteSummaryTask
これらのコマンドレットは、サイトの概要タスクを取得および設定するために使用できます。
Invoke-CMPromotePreProductionClient
このコマンドレットは、運用前クライアントを運用状態に昇格するために使用できます。
例
PR1:\> Invoke-CMPromotePreProductionClient -Force
移行
移行ジョブの新しいコマンドレット:
- Get-CMMigrationJob
- Set-CMMigrationJob
Rename-CMCategory
このコマンドレットは、カテゴリの名前を変更するために使用できます。
例
PR1:\> Get-CMCategory -Name MyCategoryName | Rename-CMCategory -NewName MyCategoryNewName -CategoryType AppCategories
コマンドレットの変更
このリリースの既存のコマンドレットに対して、次の変更が行われました。 変更は、新機能、バグ修正、または非推奨の可能性があり、破損している可能性があります。 このセクションに記載されているコマンドレットまたは機能領域のいずれかを使用する場合は、変更が使用にどのように影響するかを理解するために注意深く確認してください。
その他の変更
修正されたバグ
Url パラメーターを必要とするデプロイの種類のコマンドレットでは、パラメーター値が正しいことを検証できない場合があります (Add-CMGooglePlayDeploymentType、Set-CMWindowsPhoneStoreDeploymentType など)。
Mobile Application Management (MAM) をサポートする展開の種類のコマンドレットでは、これらの詳細がアプリケーション モデルに追加されない場合があり、"App Configuration ポリシー" タブが管理者コンソールに表示されません。
Add-CM<テクノロジ>DeploymentType コマンドレットでは、管理者コンソールと同じ名前付け規則を使用してデプロイの種類が作成されません。
ContentLocation パラメーターに予期しない引数が指定された場合、ファイル パスの代わりにファイルを必要とするデプロイの種類のコマンドレット (Add-CMMsiDeploymentType など) が、より明確なエラー原因を報告するようになりました。
重大でない変更
WMI オブジェクトを表す_プロバイダー データ_GENERIC、Windows PowerShell コンソールにさらに多くのデータが表示されるようになりました。
管理者コンソールから "Windows PowerShell ISE 経由で接続する"
修正されたバグ
ConfigurationManager モジュールへの無効なパスが原因で、生成されたスクリプトが実行されませんでした。 無効なスクリプトが既に生成されている場合は、既存の %TEMP%\ISEConnect_sitecode - sitename.ps1 ファイルを削除し、管理者コンソールから ISE を再起動します。
管理者コンソール言語パックがインストールされている場合、生成されたスクリプトが読み取れない場合があります。 無効なスクリプトが既に生成されている場合は、既存の %TEMP%\ISEConnect_sitecode - sitename.ps1 ファイルを削除し、管理者コンソールから ISE を再起動します。
管理者コンソールから ISE を起動するときに、無効なパス エラーが発生する可能性があります。
Add-CMDeploymentType
修正されたバグ
コマンドレットは、"予期しないサイト バージョン" 警告を返す場合があります。
Add-CMDeviceCollectionQueryMembershipRule
修正されたバグ
コマンドレットは、 QueryExpression パラメーターで指定されたクエリの有効性を検証しません。 名前が重複するクエリ ルールを作成できません (管理者コンソールの動作と一致しません)。
Add-CMDriverToDriverPackage
修正されたバグ
パイプライン化されたオブジェクトは、コマンドレットによって破棄される場合があります。
Add-CMEndpointProtectionPoint
修正されたバグ
サイトに初めてエンドポイント保護ポイントを追加すると、既定のクライアント設定の構成が正しくない可能性があります。
Add-CMIntuneSubscription
修正されたバグ
ContactEmail パラメーターは、正確性の検証を実行しません。
Add-CMMsiDeploymentType
修正されたバグ
EnableBranchCache パラメーター値は無視されます。
重大でない変更
InstallationBehaviorType パラメーターを追加しました。
Add-CMScriptDeploymentType
修正されたバグ
EnableBranchCache パラメーター値は無視されます。
重大でない変更
InstallationBehaviorType パラメーターを追加しました。
Add-CMUserCollectionQueryMembershipRule
修正されたバグ
コマンドレットは、 QueryExpression パラメーターで指定されたクエリの有効性を検証しません。
名前が重複するクエリ ルールを作成できません (管理者コンソールの動作と一致しません)。
Block-CMDevice
重大でない変更
コマンドレットが Get-CMDevice からパイプライン化されたオブジェクトを受け入れるようになりました。
Export-CMUserCollection
破壊的変更
コマンドレットでは、 ExportFilePath 引数が .mof ファイル拡張子で終了する必要があります。
Get-CMCategory
重大でない変更
CategoryType パラメーターの検証が強化されました。
Get-CMClientSetting
修正されたバグ
SettingType パラメーターは無視できます。
Get-CMDeploymentTypeDependency
修正されたバグ
コマンドレットによって予期しない依存関係が返される場合があります。
Get-CMDeviceAction
修正されたバグ
PinReset アクションの新しいパスコードを表示できません。
Get-CMResource
修正されたバグ
高速パラメーターがありません。
Get-CMSiteRole
破壊的変更
プライマリ サイトに接続されていて 、SiteCode パラメーターが指定されていない場合は、接続されたサイトに固有のロールのみが返されます。 この変更は、管理者コンソールとのパリティと整合性を確保するために行われました。 たとえば、CAS があり、プライマリ サイトでコマンドレットを実行している場合は、現在のサイト コードのサイト ロールのみが使用されます。 CAS から実行すると、すべてのサイトのサイト ロールが返されます。
以前の動作を復元するために、 AllSites パラメーターを使用して、階層内のすべてのサイトに接続されているサイトからクエリを実行できます。
Get-CMSoftwareUpdate
修正されたバグ
UpdateGroup パラメーター値は、コマンドレットによって破棄される場合があります。
Import-CMAntimalwarePolicy
修正されたバグ
以前のバージョンのConfiguration Managerからエクスポートされたポリシーは、適切にインポートできないことがあります。
Import-CMAntimalwarePolicy
修正されたバグ
ポリシーのインポートに失敗するか、検証エラーで作成される可能性があります。
コマンドレットを使用すると、既にインポートされているファイルをインポートできます。
Import-CMComputerInformation
破壊的変更
CollectionName パラメーターが必須になりました。
重大でない変更
完全修飾ドメイン名によるコンピューターのインポートのサポートが追加されました。
Import-CMDriver
破壊的変更
部分的なドライバーのインポートが発生した場合、コマンドレットは失敗しなくなります。 代わりに、一部のドライバーが正常にインポートされなかったことを警告します。 ドライバーをインポートできない場合でも、コマンドレットは失敗します。
Import-CMDriverPackage
重大でない変更
パッケージが既に存在する場合の動作を制御する新しい ImportActionType パラメーター。
Import-CMPackage
重大でない変更
パッケージが既に存在する場合の動作を制御する新しい ImportActionType パラメーター。
Import-CMSecurityRole
修正されたバグ
コマンドレットでは、無効な NewRoleName パラメーター値を使用できます。
Import-CMTaskSequence
重大でない変更
パッケージが既に存在する場合の動作を制御する新しい ImportActionType パラメーター。
Invoke-CMDeviceAction
修正されたバグ
特定の検出情報がターゲット デバイスで使用できない場合、コマンドレットは例外で失敗する可能性があります。
Invoke-CMDeviceRetire
修正されたバグ
ユーザーが廃止操作を呼び出すアクセス許可を持っていない場合、コマンドレットはサイレント モードで失敗します。
サポートされていないデバイスを廃止しようとすると、コマンドレットはクリア エラー メッセージで失敗しません。
ワイプされたデバイスを削除しようとすると、コマンドレットはクリア エラー メッセージで失敗しません。
重大でない変更
保留中 の デバイスを取り消す新しい Cancel パラメーターが廃止されました。
Invoke-CMDeviceWipe
修正されたバグ
ユーザーにワイプ操作を呼び出すアクセス許可がない場合、コマンドレットはサイレント モードで失敗します。
サポートされていないデバイスをワイプしようとすると、コマンドレットはクリア エラー メッセージで失敗しません。
管理対象デバイスIntuneワイプできない場合があります。
重大でない変更
保留中 の デバイス ワイプを取り消す新しい Cancel パラメーター。
Invoke-CMSoftwareUpdateAutoDeploymentRule
修正されたバグ
パイプライン化されたオブジェクトは、コマンドレットによって破棄される場合があります。
Move-CMObject
修正されたバグ
コマンドレットは、移動するオブジェクトを見つけることができません。
New-CMBootableMedia
修正されたバグ
コマンドレットは、 CertificateExpireTime パラメーター値と CertificateStartTime パラメーター値を正しく検証しません。
New-CMCaptureMedia
破壊的変更
不要な PrestartCommand パラメーターと PrestartPackage パラメーターを 削除しました。
New-CMCategory
修正されたバグ
コマンドレットを使用すると、サポートされていない GlobalCondition カテゴリの種類を作成できます。
重大でない変更
CategoryType パラメーターの検証が強化されました。
New-CMClientSetting
破壊的変更
SettingType パラメーターが必須になりました。
New-CMComputerAssociation
重大でない変更
パフォーマンスの改善。
New-CMDeviceVariable
修正されたバグ
CAS からプライマリ サイト メンバーのデバイス変数を作成できません。
パイプライン化されたコレクション オブジェクトは、コマンドレットによって破棄される場合があります。
New-CMGlobalCondition
修正されたバグ
InstanceName パラメーター値の長さは検証されません。
重大でない変更
base64 と xml のデータ型の設定を作成する機能を追加しました。
New-CMPowerManagementCustomPlan
修正されたバグ
DisplayOffMinAC パラメーターと DisplayOffMinDC パラメーターは、結果のプランでは構成されません。
New-CMPrestageMedia
重大でない変更
MediaPassword、TaskSequence、IncludeApplicationDependency パラメーターを追加しました。
New-CMQuery
修正されたバグ
コマンドレットは、クエリ名が既に存在するかどうかを検証しません。
New-CMTaskSequence
修正されたバグ
UpgradeOperatingSystem パラメーターが使用されている場合、ロールバックは構成されません。
UpgradeOperatingSystem パラメーターが使用されている場合、更新とアプリケーションのステップは想定される位置に配置されません。
New-CMWindowsEnrollmentProfile
修正されたバグ
登録プロファイルに有効なイントラネット構成が含まれていない可能性があります。
Remove-CMAdministrativeUser
破壊的変更
機能しない RoleName パラメーターを削除しました。
Remove-CMContentDistribution
修正されたバグ
パイプライン化されたオブジェクトは、コマンドレットによって破棄される場合があります。
Remove-CMDeviceVariable
修正されたバグ
存在しない変数を削除しようとすると、コマンドレットは自動的に失敗します。
プライマリ サイト メンバーのデバイス変数を CAS から削除できません。
コマンドレットは、有効なパイプライン化されたコレクション メンバー オブジェクトを拒否する場合があります。
Remove-CMIntuneSubscription
修正されたバグ
Microsoft Intune サブスクリプションが存在しない場合、コマンドレットがサイレント モードで失敗したり、不明なエラー メッセージが表示されたりすることがあります。
Remove-CMMaintenanceWindow
修正されたバグ
コマンドレットでは 、Name パラメーターが無視され、追加のメンテナンス期間が削除される場合があります。
重大でない変更
コマンドレットでは、Name パラメーターの DisableWildcardHandling パラメーター ヒントがサポートされています。
Remove-CMMulticastServicePoint
修正されたバグ
パラメーター RemoveWDS を false の 値で指定すると、WDS 機能が削除される可能性があります。
Set-CMAppVVirtualEnvironment
修正されたバグ
AddApplicationGroup パラメーターは、グループが既に追加されているかどうかを確認しません。
Set-CMBaselineDeployment
修正されたバグ
展開に対して強制が有効になっていない場合、コマンドレットでは OverrideServiceWindow が自動的に無視されることがあります。
Set-CMBoundaryGroup
修正されたバグ
DefaultSiteCode パラメーターでは、設定をクリアするための null 値は許可されません。
Set-CMClientSetting
非推奨
コマンドレットは非推奨になり、機能固有のコマンドレットに置き換えられました。 詳細については、「 新しいコマンドレット 」を参照してください。
Set-CMCollectionMembershipEvaluationComponent
非推奨
SiteSystemServerName パラメーターは非推奨になりました。
Set-CMCollectionPowerManagement
修正されたバグ
電源管理ポリシーを NeverApply から適用に変更できません。
Set-CMConditionalAccessPolicy
修正されたバグ
名前または Id パラメーターを使用してポリシーを指定するときに、コマンドレットが除外されたコレクションを変更できない場合があります。
Set-CMDeploymentType
修正されたバグ
コマンドレットは、"予期しないサイト バージョン" 警告を返す場合があります。
Set-CMDeviceVariable
修正されたバグ
存在しない変数を設定しようとすると、コマンドレットは自動的に失敗します。
CAS からプライマリ サイト メンバーのデバイス変数を構成できません。
コマンドレットは、有効なパイプライン化されたコレクション メンバー オブジェクトを拒否する場合があります。
重大でない変更
結果として得られるデバイス変数を返す新しい PassThru パラメーター。
Set-CMDistributionPoint
修正されたバグ
コマンドレットは、マルチキャスト サービス ポイントの構成に関する予期しない警告を返す場合があります。
Set-CMFileReplicationRoute
修正されたバグ
レプリケーション モードを指定せずに FileReplicationAccountName を設定することはできません。
Set-CMGlobalCondition
修正されたバグ
InstanceName パラメーター値の長さは検証されません。
Set-CMIntuneSubscription
修正されたバグ
ContactEmail パラメーターは、正確性の検証を実行しません。
Set-CMIntuneSubscriptionAppleMdmProperty
修正されたバグ
コマンドレットは、特定の必須パラメーターの依存関係が満たされていない場合に警告を表示しない場合があります。
Set-CMIntuneSubscriptionPassportForWorkProperty
修正されたバグ
EnableBiometrics パラメーター値 は無視できます。
Set-CMIntuneSubscriptionWindowsPhoneProperty
修正されたバグ
特定の無効なパラメーターの組み合わせが使用されている場合、コマンドレットが失敗しない可能性があります。
Set-CMMigrationJob
修正されたバグ
MigrationJobSchedule パラメーターを指定せずに UtcTime パラメーターを指定すると、移行ジョブの構成が無効になる可能性があります。
Set-CMMigrationSource
修正されたバグ
既に存在する名前を持つ移行ソースを作成しようとすると、コマンドレットは自動的に失敗します。
重大でない変更
完全修飾ドメイン名が使用されていない場合、コマンドレットは SourceSiteServerName パラメーター値の展開を試みます。
Set-CMMsiDeploymentType
重大でない変更
InstallationBehaviorType パラメーターを追加しました。
Set-CMScriptDeploymentType
重大でない変更
InstallationBehaviorType パラメーターを追加しました。
Set-CMSite
修正されたバグ
SiteCode パラメーターを使用すると、コマンドレットが失敗する可能性があります。
重大でない変更
未使用の追加パラメーター セット (SetSecurityScopeByName、SetSecurityScopeBySiteCode、SetSecurityScopeByValue) を削除しました。
Set-CMSiteMaintenanceTask
破壊的変更
SiteCode パラメーターが削除されました。
非推奨
SummaryTask パラメーターは非推奨になりました。 代わりに TaskName を使用する必要があります。
重大でない変更
Get-CMSiteMaintenanceTask からのパイプライン入力を受け入れます。
いくつかの使いやすさの向上。
タスクを名前で設定するための TaskName パラメーターを追加しました。
Set-CMSoftwareUpdateDeployment
重大でない変更
Confirm または WhatIf を使用するときの出力が改善されました。
Set-CMSoftwareUpdatePointComponent
修正されたバグ
AddCompany パラメーターの値として "Local Publisher" を指定することはできません。
Set-CMSoftwareUpdateSummarizationSchedule
重大でない変更
Confirm または WhatIf を使用するときの出力が改善されました。
Start-CMBaselineDeployment
修正されたバグ
展開に対して強制が有効になっていない場合、コマンドレットでは OverrideServiceWindow が自動的に無視されることがあります。
Start-CMContentDistribution
修正されたバグ
パイプライン化されたオブジェクトは、コマンドレットによって破棄される場合があります。
Start-CMTaskSequenceDeployment
修正されたバグ
DeploymentOption パラメーターが指定されていない場合、デプロイが正しく作成されない可能性があります。
コマンドレットは、 PercentSuccess パラメーターまたは PercentFailure パラメーターが指定されていない場合に無視されるという警告を返す場合があります。
重大でない変更
DeploymentOption が指定されていない場合は、DownloadContentLocallyWhenNeedededByRunningTaskSequence の値が暗黙的に指定されます。
Unblock-CMDevice
重大でない変更
コマンドレットが Get-CMDevice からパイプライン化されたオブジェクトを受け入れるようになりました。
Unlock-CMObject
重大でない変更
別の SMS プロバイダー セッションによってロックされているオブジェクトのロックを解除しようとすると、コマンドレットは失敗します。 以前のリリースでは、これはサイレント モードで失敗します。
別の SMS プロバイダー セッションによってロックされている可能性があるオブジェクトのロック解除を試みるために Force パラメーターを追加しました。 これは、オブジェクトロックを解除せずに予期せず終了する管理者コンソールによってオブジェクトがロックされたシナリオから回復するために使用できます。