Win32_Desktop clase

Artículo
06/12/2023

La Win32_Desktopclase WMI representa las características comunes del escritorio de un usuario. El usuario puede modificar las propiedades de esta clase para personalizar el escritorio.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

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

Miembros

La clase Win32_Desktop tiene estos tipos de miembros:

Propiedades

Propiedades

La clase Win32_Desktop tiene estas propiedades.

BorderWidth

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop\\WindowMetrics| BorderWidth")

Ancho de los bordes alrededor de todas las ventanas con bordes ajustables.

Ejemplo: 3

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64)

Breve descripción textual del objeto actual.

Esta propiedad se hereda de CIM_Setting.

CoolSwitch

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|Panel de control \\Escritorio| CoolSwitch")

El cambio rápido de tareas está activado. El cambio rápido de tareas permite al usuario cambiar entre ventanas mediante la combinación de teclado ALT+TAB .

CursorBlinkRate

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|Panel de control \\Escritorio| CursorBlinkRate"), unidades ("milisegundos")

Período de tiempo entre los cursores sucesivos parpadea.

Ejemplo: 530

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción textual del objeto actual.

Esta propiedad se hereda de CIM_Setting.

DragFullWindows

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|Panel de control \\Escritorio| DragFullWindows")

El contenido de una ventana se muestra cuando un usuario mueve la ventana.

GridGranularity

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|Panel de control \\Escritorio| GridGranularity"), Unidades ("8 píxeles")

Espaciado de la cuadrícula a la que están enlazadas las ventanas en el escritorio. Esto facilita la organización de ventanas. El espaciado suele ser lo suficientemente fino como para que el usuario no lo observe.

Ejemplo: 1

IconSpacing

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop\\WindowMetrics| IconSpacing"), Unidades ("píxeles")

Espaciado entre iconos.

Ejemplo: 75

IconTitleFaceName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop\\WindowMetrics| IconFont")

Fuente usada para los nombres de los iconos.

Ejemplo: "MS San Serif"

IconTitleSize

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32API| Estructuras de fuente y texto| LOGFONTW|lfHeight"), Unidades ("point")

Tamaño de fuente del icono.

Ejemplo: 9

IconTitleWrap

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop\\WindowMetrics| IconTitleWrap")

El texto del título del icono se ajusta a la línea siguiente.

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: key, MappingStrings ("WMI")

Nombre que identifica el perfil de escritorio actual.

Ejemplo: "MainProf"

Patrón

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| Patrón")

Nombre del patrón usado como fondo para el escritorio.

ScreenSaverActive

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| ScreenSaveActive")

El protector de pantalla está activo.

ScreenSaverExecutable

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop|SCRNSAVE.EXE")

Nombre del archivo ejecutable del protector de pantalla actual.

Ejemplo: "LOGON. SCR"

ScreenSaverSecure

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| ScreenSaverIsSecure")

La contraseña está habilitada para el protector de pantalla.

ScreenSaverTimeout

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| ScreenSaveTimeOut"), Unidades ("segundos")

Cantidad de tiempo que pasa antes de que se inicie el protector de pantalla.

SettingID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (256)

Identificador por el que se conoce el objeto actual.

Esta propiedad se hereda de CIM_Setting.

Fondo de pantalla

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| Fondo de pantalla")

Nombre de archivo para el diseño del fondo de pantalla en el fondo del escritorio.

Ejemplo: "WINNT.BMP"

WallpaperStretched

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| WallpaperStyle")

El fondo de pantalla se estira para rellenar toda la pantalla. Microsoft Plus! debe instalarse antes de que esta opción esté disponible. Si es FALSE, el fondo de pantalla conserva sus dimensiones originales en el fondo del escritorio.

Papel tapizTilado

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("Win32Registry|. DEFAULT\\Panel de control\\Desktop| TileWallpaper")

El fondo de pantalla está en mosaico o centrado.

Comentarios

La clase Win32_Desktop se deriva de CIM_Setting.

El proceso de llamada que usa esta clase debe tener el privilegio SE_RESTORE_NAME en el equipo en el que reside el Registro. Por ejemplo, si enumera esta clase en el equipo local, la cuenta con la que se ejecuta la aplicación debe tener este privilegio. Para más información, vea Ejecución de operaciones con privilegios.

Ejemplos

En el ejemplo de código siguiente se describe cómo recuperar información de escritorio.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Setting
Clases de sistema operativo

Compartir a través de

Win32_Desktop clase

Sintaxis

Miembros

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Recursos adicionales