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 类具有这些属性。
-
BorderWidth
-
-
数据类型： uint32
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |BorderWidth“)
所有窗口周围的边框宽度，边框可调整。
示例：3
-
-
Caption
-
-
数据类型： 字符串
-
访问类型：只读
-
限定符： MaxLen (64)
当前对象的简短文本说明。
此属性继承自 CIM_Setting。
-
-
CoolSwitch
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|控制面板\\Desktop|CoolSwitch“)
快速任务切换已打开。 快速任务切换允许用户使用 ALT+TAB 键盘组合在窗口之间切换。
-
-
CursorBlinkRate
-
-
数据类型： uint32
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|控制面板\\Desktop|CursorBlinkRate“) ，单位 (”毫秒“)
连续光标闪烁之间的时间长度。
示例：530
-
-
描述
-
-
数据类型： 字符串
-
访问类型：只读
当前对象的文本说明。
此属性继承自 CIM_Setting。
-
-
DragFullWindows
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|控制面板\\Desktop|DragFullWindows“)
当用户移动窗口时，将显示窗口的内容。
-
-
GridGranularity
-
-
数据类型： uint32
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|控制面板\\Desktop|GridGranularity“) ，单位 (”8 像素“)
窗口在桌面上绑定到的网格间距。 这样一来，组织窗口就更容易了。 间距通常足够精细，用户不会注意到它。
示例：1
-
-
IconSpacing
-
-
数据类型： uint32
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconSpacing“) ，单位 (”像素“)
图标之间的间距。
示例：75
-
-
IconTitleFaceName
-
-
数据类型： 字符串
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconFont“)
用于图标名称的字体。
示例：“MS San Serif”
-
-
IconTitleSize
-
-
数据类型： uint32
-
访问类型：只读
-
限定符： MappingStrings (“Win32API|字体和文本结构 |LOGFONTW|lfHeight“) ， 单位 (”point“)
图标字号。
示例：9
-
-
IconTitleWrap
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop\\WindowMetrics |IconTitleWrap“)
图标的标题文本换行到下一行。
-
-
名称
-
-
数据类型： 字符串
-
访问类型：只读
-
限定符： key、 MappingStrings (“WMI”)
标识当前桌面配置文件的名称。
示例：“MainProf”
-
-
模式
-
-
数据类型： 字符串
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|Pattern“)
用作桌面背景的模式的名称。
-
-
ScreenSaverActive
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|ScreenSaveActive“)
屏幕保护程序处于活动状态。
-
-
ScreenSaverExecutable
-
-
数据类型： 字符串
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|”。DEFAULT\\控制面板\\Desktop|SCRNSAVE.EXE“)
当前屏幕保护程序可执行文件的名称。
示例：“LOGON。SCR”
-
-
ScreenSaverSecure
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|ScreenSaverIsSecure“)
为屏幕保护程序启用了密码。
-
-
ScreenSaverTimeout
-
-
数据类型： uint32
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|ScreenSaveTimeOut“) ，单位 (”秒“)
屏幕保护程序启动前经过的时间量。
-
-
SettingID
-
-
数据类型： string
-
访问类型：只读
-
限定符： MaxLen (256)
已知当前对象的标识符。
此属性继承自 CIM_Setting。
-
-
壁纸
-
-
数据类型： string
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|壁纸“)
桌面背景上的壁纸设计的文件名。
示例：“WINNT.BMP”
-
-
WallpaperStretched
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：MappingStrings (“Win32Registry|。DEFAULT\\控制面板\\Desktop|壁纸风格“)
壁纸被拉伸以填满整个屏幕。 Microsoft Plus！ 必须先安装此选项，然后才能使用此选项。 如果 为 FALSE，则壁纸在桌面背景上保留其原始尺寸。
-
-
壁纸平铺
-
-
数据类型： 布尔值
-
访问类型：只读
-
限定符：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 |
|