【 Get-MgDeviceManagementDeviceConfiguration 】コマンドレット――Microsoft Intuneに登録された構成プロファイルの情報を参照する:Windows PowerShell基本Tips(109)
本連載は、PowerShellコマンドレットについて、基本書式からオプション、具体的な実行例までを紹介していきます。今回は「Get-MgDeviceManagementDeviceConfiguration」コマンドレットを解説します。
本連載では、Windows PowerShellの基本的なコマンドレットについて、基本的な書式からオプション、具体的な実行例までを分かりやすく紹介していきます。今回は、「Microsoft Intune」に登録された構成プロファイルの情報を参照する「Get-MgDeviceManagementDeviceConfiguration」コマンドレットです。
Get-MgDeviceManagementDeviceConfigurationコマンドレットとは?
「Get-MgDeviceManagementDeviceConfiguration」は、Microsoft Intuneに登録されたデバイスに対し、ポリシーを割り当てる際に利用する「構成プロファイル」を参照するコマンドレットです。ITIL(Information Technology Infrastructure Library)における構成管理の一環として、Microsoft Intuneに登録された構成プロファイル情報をWindows PowerShellで取り出し、テキストデータとして保存するといった使い方が可能です。
なお、Get-MgDeviceManagementDeviceConfigurationコマンドレットは、本連載第45回で解説した「Connect-MgGraph」コマンドレットで「Connect-MgGraph -Scopes "DeviceManagementConfiguration.Read.All"」と実行して、Microsoft Intuneへのアクセス許可を与えておくことが前提条件になります。
Get-MgDeviceManagementDeviceConfigurationコマンドレットの書式
Get-MgDeviceManagementDeviceConfiguration [オプション]
Get-MgDeviceManagementDeviceConfigurationコマンドレットの主なオプション
オプション | 意味 |
---|---|
-Property | 特定の属性情報を表示する。省略可能 |
-DeviceConfigurationId | 特定の構成プロファイルの情報を表示する。省略可能 |
Microsoft Intuneに登録された構成プロファイルの一覧を参照する
オプションを指定せずにGet-MgDeviceManagementDeviceConfigurationコマンドレットを実行すると、構成プロファイルの一覧を参照できますが、その一覧には有効な情報が表示されません。そこで、Get-MgDeviceManagementDeviceConfigurationコマンドレットを実行する際には「-Property」オプションで“明示的に表示させたい属性を指定する”必要があります(画面1)。
Copyright © ITmedia, Inc. All Rights Reserved.