Win32_Desktop classe
La classe WMI Win32_Desktop représente les caractéristiques communes du bureau d’un utilisateur. Les propriétés de cette classe peuvent être modifiées par l’utilisateur pour personnaliser le bureau.
La syntaxe suivante est simplifiée par rapport au code MOF (Managed Object Format) et inclut toutes les propriétés héritées. Les propriétés sont répertoriées dans l’ordre alphabétique, et non dans l’ordre MOF.
Syntaxe
[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;
};
Membres
La classe Win32_Desktop a les types de membres suivants :
Propriétés
La classe Win32_Desktop a ces propriétés.
-
BorderWidth
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| BorderWidth »)
Largeur des bordures autour de toutes les fenêtres avec bordures réglables.
Exemple : 3
-
-
Caption
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (64)
Brève description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
-
-
CoolSwitch
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|Panneau de configuration \\Desktop| CoolSwitch »)
Le basculement rapide des tâches est activé. Le basculement rapide des tâches permet à l’utilisateur de basculer entre les fenêtres à l’aide de la combinaison clavier ALT+TAB .
-
-
CursorBlinkRate
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|Panneau de configuration \\Desktop| CursorBlinkRate »), Unités (« millisecondes »)
Durée entre les curseurs successifs clignote.
Exemple : 530
-
-
Description
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
Description textuelle de l’objet actuel.
Cette propriété est héritée de CIM_Setting.
-
-
DragFullWindows
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|Panneau de configuration \\Desktop| DragFullWindows »)
Le contenu d’une fenêtre s’affiche lorsqu’un utilisateur déplace la fenêtre.
-
-
GridGranularity
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|Panneau de configuration \\Desktop| GridGranularity »), Units (« 8 pixels »)
Espacement de la grille à laquelle les fenêtres sont liées sur le bureau. Cela facilite l’organisation des fenêtres. L’espacement est généralement suffisamment précis pour que l’utilisateur ne le remarque pas.
Exemple : 1
-
-
IconSpacing
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| IconSpacing »), Unités (« pixels »)
Espacement entre les icônes.
Exemple : 75
-
-
IconTitleFaceName
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| IconFont »)
Police utilisée pour les noms des icônes.
Exemple : « MS San Serif »
-
-
IconTitleSize
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32API| Structures de police et de texte | LOGFONTW|lfHeight »), Unités (« point »)
Taille de police de l’icône.
Exemple : 9
-
-
IconTitleWrap
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop\\WindowMetrics| IconTitleWrap »)
Le texte de titre de l’icône est renvoyé à la ligne suivante.
-
-
Nom
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : key, MappingStrings (« WMI »)
Nom qui identifie le profil de bureau actuel.
Exemple : « MainProf »
-
-
Modèle
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| Modèle « )
Nom du modèle utilisé comme arrière-plan pour le bureau.
-
-
ScreenSaverActive
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| ScreenSaveActive »)
L’économiseur d’écran est actif.
-
-
ScreenSaverExecutable
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop|SCRNSAVE.EXE »)
Nom du fichier exécutable de l’économiseur d’écran actuel.
Exemple : « LOGON. SCR »
-
-
ScreenSaverSecure
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| ScreenSaverIsSecure »)
Le mot de passe est activé pour l’économiseur d’écran.
-
-
ScreenSaverTimeout
-
-
Type de données : uint32
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| ScreenSaveTimeOut »), Unités (« secondes »)
Durée qui s’écoule avant le démarrage de l’économiseur d’écran.
-
-
SettingID
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MaxLen (256)
Identificateur par lequel l’objet actuel est connu.
Cette propriété est héritée de CIM_Setting.
-
-
Papier peint
-
-
Type de données : chaîne
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| Papier peint »)
Nom de fichier pour la conception du papier peint sur l’arrière-plan du bureau.
Exemple : « WINNT.BMP »
-
-
WallpaperStretched
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| WallpaperStyle »)
Le papier peint est étiré pour remplir l’intégralité de l’écran. Microsoft Plus ! doit être installé avant que cette option soit disponible. Si la valeur est FALSE, le papier peint conserve ses dimensions d’origine sur l’arrière-plan du bureau.
-
-
WallpaperTiled
-
-
Type de données : booléen
-
Type d'accès : Lecture seule
-
Qualificateurs : MappingStrings (« Win32Registry|. DEFAULT\\Panneau de configuration\\Desktop| TileWallpaper »)
Le papier peint est en mosaïque ou centré.
-
Notes
La classe Win32_Desktop est dérivée de CIM_Setting.
Le processus appelant qui utilise cette classe doit avoir le privilège SE_RESTORE_NAME sur l’ordinateur sur lequel réside le Registre. Par exemple, si vous énumérez cette classe sur l’ordinateur local, le compte sous lequel votre application s’exécute doit disposer de ce privilège. Pour plus d’informations, consultez Exécution d’opérations privilégiées.
Exemples
L’exemple de code suivant décrit comment récupérer des informations de bureau.
$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
""
}
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| Espace de noms |
Racine\CIMV2 |
| MOF |
|
| DLL |
|
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour