Win32_Desktop クラス

[アーティクル]
06/12/2023

Win32_DesktopWMI クラスは、ユーザーのデスクトップの一般的な特性を表します。このクラスのプロパティは、ユーザーがデスクトップをカスタマイズするように変更できます。

次の構文はマネージドオブジェクトフォーマット (MOF) のコードを単純化したもので、すべての継承されたプロパティを含みます。プロパティは、MOF の順序ではなく、アルファベット順で一覧表示されます。

構文

[Dynamic, Provider("CIMWin32"), Privileges("SeRestorePrivilege"), UUID("{8502C4E3-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_Desktop : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  uint32  BorderWidth;
  boolean CoolSwitch;
  uint32  CursorBlinkRate;
  boolean DragFullWindows;
  uint32  GridGranularity;
  uint32  IconSpacing;
  string  IconTitleFaceName;
  uint32  IconTitleSize;
  boolean IconTitleWrap;
  string  Name;
  string  Pattern;
  boolean ScreenSaverActive;
  string  ScreenSaverExecutable;
  boolean ScreenSaverSecure;
  uint32  ScreenSaverTimeout;
  string  Wallpaper;
  boolean WallpaperStretched;
  boolean WallpaperTiled;
};

メンバー

Win32_Desktop クラスには、次の種類のメンバーがあります。

Properties

プロパティ

Win32_Desktop クラスには、これらのプロパティがあります。

境界線幅

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop\\WindowMetrics|BorderWidth")

調整可能な罫線を持つすべてのウィンドウの周囲の罫線の幅。

例: 3

Caption

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (64)

現在のオブジェクトの短いテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

CoolSwitch

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|コントロールパネル\\Desktop|CoolSwitch")

高速タスク切り替えがオンになっています。タスクの切り替えを高速にすると、 ユーザーは Alt + TAB キーボードの組み合わせを使用してウィンドウを切り替えることができます。

CursorBlinkRate

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|コントロールパネル\\Desktop|CursorBlinkRate")、単位 ("ミリ秒")

カーソルが連続して点滅する時間の長さ。

例: 530

説明

データ型: string
アクセスの種類: 読み取り専用

現在のオブジェクトのテキスト説明。

このプロパティは、 CIM_Settingから継承されます。

DragFullWindows

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|コントロールパネル\\Desktop|DragFullWindows")

ウィンドウの内容は、ユーザーがウィンドウを移動すると表示されます。

GridGranularity

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|コントロールパネル\\Desktop|GridGranularity")、単位 ("8 ピクセル")

デスクトップ上でウィンドウがバインドされているグリッドの間隔。これにより、ウィンドウの整理が容易になります。通常、ユーザーが気付かないほど間隔は十分です。

例: 1

アイコンSpacing

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop\\WindowMetrics|IconSpacing")、単位 ("ピクセル")

アイコン間の間隔。

例: 75

IconTitleFaceName

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop\\WindowMetrics|IconFont")

アイコンの名前に使用されるフォント。

例: "MS San Serif"

IconTitleSize

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32API|フォントとテキストの構造|LOGFONTW|lfHeight"), Units ("point")

アイコンのフォントサイズ。

例: 9

IconTitleWrap

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop\\WindowMetrics|IconTitleWrap")

アイコンのタイトルテキストが次の行に折り返されます。

Name

データ型: string
アクセスの種類: 読み取り専用
修飾子: key、 MappingStrings ("WMI")

現在のデスクトッププロファイルを識別する名前。

例: "MainProf"

パターン

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|Pattern")

デスクトップの背景として使用されるパターンの名前。

ScreenSaverActive

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|ScreenSaveActive")

スクリーンセーバーがアクティブです。

ScreenSaverExecutable

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|SCRNSAVE.EXE")

現在のスクリーンセーバー実行可能ファイルの名前。

例: "LOGON.SCR"

ScreenSaverSecure

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|ScreenSaverIsSecure")

スクリーンセーバーに対してパスワードが有効になっています。

ScreenSaverTimeout

データ型: uint32
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|ScreenSaveTimeOut"),Units ("seconds")

スクリーンセーバーが開始されるまでに経過する時間。

SettingID

データ型: string
アクセスの種類: 読み取り専用
修飾子: MaxLen (256)

現在のオブジェクトが認識される識別子。

このプロパティは、 CIM_Settingから継承されます。

壁紙

データ型: string
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|壁紙")

デスクトップの背景にある壁紙デザインのファイル名。

例: "WINNT.BMP"

WallpaperStretched

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|WallpaperStyle")

壁紙は、画面全体を埋めるために引き伸ばされます。 Microsoft Plus! は、このオプションを使用する前にインストールする必要があります。 FALSE の場合、壁紙はデスクトップの背景に元の寸法を保持します。

WallpaperTiled

データ型: ブール値
アクセスの種類: 読み取り専用
修飾子: MappingStrings ("Win32Registry|.DEFAULT\\コントロールパネル\\Desktop|TileWallpaper")

壁紙はタイルまたは中央揃えです。

注釈

Win32_Desktop クラスは、CIM_Settingから派生します。

このクラスを使用する呼び出し元プロセスには、レジストリが存在するコンピューターに対する SE_RESTORE_NAME 特権が必要です。たとえば、ローカルコンピューターでこのクラスを列挙する場合、アプリケーションを実行するアカウントには、この特権が必要です。詳細については、「特権操作の実行」を参照してください。

例

次のコードサンプルでは、デスクトップ情報を取得する方法について説明します。

$desktops = Get-WmiObject win32_desktop

"This system has {0} desktop objects" -f $desktops.length
Foreach ($dt in $desktops) {
"Desktop {0}" -f $i++
"  BorderWidth           : {0}" -f $dt.BorderWidth 
"  Caption               : {0}" -f $dt.Caption
"  CoolSwitch            : {0}" -f $dt.CoolSwitch
"  CursorBlinkRate       : {0}" -f $dt.CursorBlinkRate
"  Description           : {0}" -f $dt.Description 
"  DragFullWindows       : {0}" -f $dt.DragFullWindows
"  GridGranularity       : {0}" -f $dt.GridGranularity 
"  IconSpacing           : {0}" -f $dt.IconSpacing
"  IconTitleFaceName     : {0}" -f $dt.IconTitleFaceName
"  IconTitleSize         : {0}" -f $dt.IconTitleSize
"  IconTitleWrap         : {0}" -f $dt.conTitleWrap
"  Name                  : {0}" -f $dt.Name
"  Pattern               : {0}" -f $dt.Pattern 
"  ScreenSaverActive     : {0}" -f $dt.ScreenSaverActive
"  ScreenSaverExecutable : {0}" -f $dt.ScreenSaverExecutable
"  ScreenSaverSecure     : {0}" -f $dt.creenSaverSecure
"  ScreenSaverTimeout    : {0}" -f $dt.ScreenSaverTimeout
"  SettingID             : {0}" -f $dt.SettingID
"  Wallpaper             : {0}" -f $dt.Wallpaper
"  WallpaperStretched    : {0}" -f $dt.WallpaperStretched
"  WallpaperTiled        : {0}" -f $dt.WallpaperTiled
""
}

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
名前空間	Root\CIMV2
MOF	CIMWin32.mof
[DLL]	CIMWin32.dll

こちらもご覧ください

CIM_Setting
オペレーティングシステムクラス

次の方法で共有

Win32_Desktop クラス

構文

メンバー

プロパティ

注釈

例

要件

こちらもご覧ください

フィードバック

その他のリソース