Win32_Desktop クラス
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 クラスには、次の種類のメンバーがあります。
プロパティ
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 |
|
| [DLL] |
|