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
-
-
標題
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 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「) ，Units (」pixel「)
圖示之間的間距。
範例：75
-
-
IconTitleFaceName
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞：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「)
圖示的標題文字會換行至下一行。
-
-
名稱
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： 索引鍵、 MappingStrings (「WMI」)
識別目前桌面設定檔的名稱。
範例：「MainProf」
-
-
模式
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|模式「)
用來作為桌面背景的模式名稱。
-
-
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「) ，Units (」seconds「)
在螢幕保護裝置程式開始之前經過的時間量。
-
-
SettingID
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen (256)
已知目前物件的識別碼。
此屬性繼承自 CIM_Setting。
-
-
桌布
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|背景圖樣「)
桌面背景上背景的桌布設計的檔案名。
範例：「WINNT.BMP」
-
-
背景圖樣
-
-
資料類型： 布林值
-
存取類型：唯讀
-
限定詞：MappingStrings (「Win32Registry|。DEFAULT\\主控台\\Desktop|WallpaperStyle「)
背景圖樣會延展以填滿整個螢幕。 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 |
|