Win32_Desktop-Klasse

Artikel
06/12/2023

Die Win32_DesktopWMI-Klasse stellt die allgemeinen Merkmale des Desktops eines Benutzers dar. Die Eigenschaften dieser Klasse können vom Benutzer geändert werden, um den Desktop anzupassen.

Die folgende Syntax wurde aus MOF-Code (Managed Object Format, verwaltetes Objektformat) vereinfacht und enthält alle geerbten Eigenschaften. Eigenschaften werden in alphabetischer Reihenfolge und nicht in MOF-Reihenfolge aufgeführt.

Syntax

[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;
};

Member

Die Win32_Desktop-Klasse verfügt über folgende Membertypen:

Eigenschaften

Eigenschaften

Die Win32_Desktop-Klasse verfügt über diese Eigenschaften.

Rahmenbreite

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop\\WindowMetrics| BorderWidth")

Breite der Rahmen um alle Fenster mit anpassbaren Rahmen.

Beispiel: 3

Caption

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (64)

Kurze Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

CoolSwitch

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|Systemsteuerung \\Desktop| CoolSwitch")

Das schnelle Umschalten von Aufgaben ist aktiviert. Das schnelle Umschalten von Aufgaben ermöglicht es dem Benutzer, zwischen Fenstern zu wechseln, indem die Tastenkombination ALT+TAB verwendet wird.

CursorBlinkRate

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|Systemsteuerung \\Desktop| CursorBlinkRate"), Units ("Millisekunden")

Dauer zwischen aufeinanderfolgenden Cursor blinkt.

Beispiel: 530

Beschreibung

Datentyp: string
Zugriffstyp: Schreibgeschützt

Textbeschreibung des aktuellen Objekts.

Diese Eigenschaft wird von CIM_Setting geerbt.

DragFullWindows

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|Systemsteuerung \\Desktop| DragFullWindows")

Der Inhalt eines Fensters wird angezeigt, wenn ein Benutzer das Fenster verschiebt.

GridGranularity

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|Systemsteuerung \\Desktop| GridGranularity"), Units ("8 Pixels")

Abstand des Rasters, an das Fenster auf dem Desktop gebunden sind. Dies erleichtert das Organisieren von Fenstern. Der Abstand ist in der Regel so gut, dass der Benutzer ihn nicht bemerkt.

Beispiel: 1

SymbolSpacing

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop\\WindowMetrics| IconSpacing"), Units ("pixels")

Abstand zwischen Symbolen.

Beispiel: 75

IconTitleFaceName

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop\\WindowMetrics| IconFont")

Schriftart, die für die Namen der Symbole verwendet wird.

Beispiel: "MS San Serif"

IconTitleSize

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32API| Schriftarten- und Textstrukturen| LOGFONTW|lfHeight"), Einheiten ("Punkt")

Schriftgrad des Symbols.

Beispiel: 9

IconTitleWrap

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop\\WindowMetrics| IconTitleWrap")

Der Titeltext des Symbols wird in die nächste Zeile umgebrochen.

Name

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: key, MappingStrings ("WMI")

Name, der das aktuelle Desktopprofil identifiziert.

Beispiel: "MainProf"

Muster

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| Muster")

Name des Musters, das als Hintergrund für den Desktop verwendet wird.

ScreenSaverActive

Datentyp: boolean
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| ScreenSaveActive")

Der Bildschirmschoner ist aktiv.

ScreenSaverExecutable

Datentyp: string
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop|SCRNSAVE.EXE")

Name der aktuellen ausführbaren Bildschirmschonerdatei.

Beispiel: "LOGON. SCR"

ScreenSaverSecure

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| ScreenSaverIsSecure")

Kennwort ist für den Bildschirmschoner aktiviert.

ScreenSaverTimeout

Datentyp: uint32
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| ScreenSaveTimeOut"), Einheiten ("Sekunden")

Zeit, die vergeht, bevor der Bildschirmschoner gestartet wird.

SettingID

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MaxLen (256)

Bezeichner, durch den das aktuelle Objekt bekannt ist.

Diese Eigenschaft wird von CIM_Setting geerbt.

Hintergrundbild

Datentyp: Zeichenfolge
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| Hintergrundbild")

Dateiname für das Hintergrundbilddesign auf dem Desktop.

Beispiel: "WINNT.BMP"

WallpaperStretched

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| WallpaperStyle")

Hintergrundbild wird gestreckt, um den gesamten Bildschirm zu füllen. Microsoft Plus! muss installiert werden, bevor diese Option verfügbar ist. Wenn FALSE, behält das Hintergrundbild seine ursprünglichen Dimensionen auf dem Desktophintergrund bei.

WallpaperTiled

Datentyp: Boolesch
Zugriffstyp: Schreibgeschützt
Qualifizierer: MappingStrings ("Win32Registry|. DEFAULT\\Systemsteuerung\\Desktop| TileWallpaper")

Hintergrundbild ist gefliest oder zentriert.

Bemerkungen

Die Win32_Desktop-Klasse wird von CIM_Setting abgeleitet.

Der aufrufende Prozess, der diese Klasse verwendet, muss über die SE_RESTORE_NAME Berechtigungen auf dem Computer verfügen, auf dem sich die Registrierung befindet. Wenn Sie diese Klasse beispielsweise auf dem lokalen Computer auflisten, muss das Konto, unter dem Ihre Anwendung ausgeführt wird, über diese Berechtigung verfügen. Weitere Informationen finden Sie unter Ausführen privilegierter Vorgänge.

Beispiele

Im folgenden Codebeispiel wird beschrieben, wie Desktopinformationen abgerufen werden.

$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
""
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Namespace	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Siehe auch

CIM_Setting
Betriebssystemklassen

Freigeben über

Win32_Desktop-Klasse

Syntax

Member

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen