Win32_Desktop-Klasse

  • Artikel

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

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