Renommer la méthode de la classe Win32_Directory
La méthode de classe RenameWMI renomme le fichier d’entrée de répertoire spécifié dans le chemin d’accès de l’objet. Un renommage n’est pas pris en charge si la destination se trouve sur un autre lecteur ou si le remplacement d’un fichier logique existant est nécessaire.
Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.
Syntaxe
uint32 Rename(
string FileName
);
Paramètres
-
FileName
-
Nouveau nom complet du fichier (ou répertoire). Exemple : c:\temp\newfile.txt.
Valeur retournée
Retourne la valeur 0 (zéro) si le fichier a été renommé avec succès, et tout autre nombre pour indiquer une erreur.
-
0
-
La demande a abouti.
-
2
-
L’accès a été refusé.
-
8
-
Un échec non spécifié s’est produit.
-
9
-
Le nom spécifié n’était pas valide.
-
10
-
L’objet spécifié existe déjà.
-
11
-
Le système de fichiers n’est pas NTFS.
-
12
-
La plateforme n’est pas Windows.
-
13
-
Le lecteur n’est pas le même.
-
14
-
Le répertoire n'est pas vide.
-
15
-
Il y a eu une violation du partage.
-
16
-
Le fichier de démarrage spécifié n’était pas valide.
-
17
-
Un privilège requis pour l’opération n’est pas conservé.
-
21
-
Un paramètre spécifié n’est pas valide.
Notes
Pour renommer un dossier, commencez par le lier au dossier en question, puis appelez la méthode Rename. En tant que seul paramètre de la méthode, passez le nouveau nom du dossier comme nom de chemin d’accès complet. Par exemple, si le dossier dans C:\Scripts\Logs\Backup doit être renommé C:\Scripts\Archive, vous devez passer C:\Scripts\Archive comme nom complet du dossier. Le fait de passer uniquement le nom du dossier Archive génère une erreur de chemin d’accès non valide.
La classe Win32_Directory ne fournit pas de méthode en une étape pour déplacer des dossiers. Au lieu de cela, le déplacement d’un dossier implique généralement deux étapes :
- 1. Copie du dossier vers son nouvel emplacement 2. Suppression du dossier d’origine
La seule exception à ce processus en deux étapes consiste à déplacer un dossier vers un nouvel emplacement sur le même lecteur. Par exemple, supposons que vous souhaitiez déplacer C:\Temp vers C:\Scripts\Temporary Files\Archive. Tant que l’emplacement actuel et le nouvel emplacement se trouvent sur le même lecteur, vous pouvez déplacer le dossier en appelant simplement la méthode Rename et en transmettant le nouvel emplacement comme paramètre de méthode. Cette approche vous permet de déplacer le dossier en une seule étape. Toutefois, le script échoue si le lecteur actuel et le nouveau lecteur sont différents. Une tentative de renommage de C:\Temp en D:\Temp échoue avec une erreur « Le lecteur n’est pas le même ».
Exemples
Le code suivant, à partir de l’exemple Déplacer un dossier à l’aide de WMI VBScript sur TechNet Gallery, utilise la méthode Rename pour déplacer le dossier C:\Scripts vers C:\Admins\Documents\Archive\VBScript.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery _
("Select * from Win32_Directory where name = 'c:\\Scripts'")
For Each objFolder in colFolders
errResults = objFolder.Rename("C:\Admins\Documents\Archive\VBScript")
Next
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 |
|