.NET Framework Class Library
ManagementScope Class
Represents a scope (namespace) for management operations.
Assembly: System.Management (in System.Management.dll)
Syntax
Visual Basic (Declaration)
Public Class ManagementScope _ Implements ICloneable
Visual Basic (Usage)
Dim instance As ManagementScope
C#
public class ManagementScope : ICloneable
Visual C++
public ref class ManagementScope : ICloneable
JScript
public class ManagementScope implements ICloneable
Examples
The following example initializes a new ManagementScope with a specific path and then connects the scope object to a WMI namespace. The example connects to a namespace on a remote computer.
Visual Basic
Imports System Imports System.Management Public Class RemoteConnect Public Overloads Shared Function Main( _ ByVal args() As String) As Integer ' Build an options object for the remote connection ' if you plan to connect to the remote ' computer with a different user name ' and password than the one you are currently using ' Dim options As ConnectionOptions ' options = new ConnectionOptions() ' Then set the options.Username and ' options.Password properties to the correct values ' and also set ' options.Authority = "ntdlmdomain:DOMAIN" ' and replace DOMAIN with the remote computer's ' domain. You can also use kerberose instead ' of ntdlmdomain. ' Make a connection to a remote computer. ' Replace the "FullComputerName" section of the ' string "\\FullComputerName\root\cimv2" with ' the full computer name or IP address of the ' remote computer. Dim scope As ManagementScope scope = New ManagementScope( _ "\\FullComputerName\root\cimv2") scope.Connect() ' Use this code if you are connecting with a ' different user name and password: ' ' Dim scope As ManagementScope ' scope = New ManagementScope( _ ' "\\FullComputerName\root\cimv2", options) ' scope.Connect() ' Query system for Operating System information Dim query As ObjectQuery query = New ObjectQuery( _ "SELECT * FROM Win32_OperatingSystem") Dim searcher As ManagementObjectSearcher searcher = _ New ManagementObjectSearcher(scope, query) Dim queryCollection As ManagementObjectCollection queryCollection = searcher.Get() Dim m As ManagementObject For Each m In queryCollection ' Display the remote computer information Console.WriteLine("Computer Name : {0}", _ m("csname")) Console.WriteLine("Windows Directory : {0}", _ m("WindowsDirectory")) Console.WriteLine("Operating System: {0}", _ m("Caption")) Console.WriteLine("Version: {0}", m("Version")) Console.WriteLine("Manufacturer : {0}", _ m("Manufacturer")) Next Return 0 End Function End Class
C#
using System; using System.Management; public class RemoteConnect { public static void Main() { /*// Build an options object for the remote connection // if you plan to connect to the remote // computer with a different user name // and password than the one you are currently using ConnectionOptions options = new ConnectionOptions(); // and then set the options.Username and // options.Password properties to the correct values // and also set // options.Authority = "ntdlmdomain:DOMAIN"; // and replace DOMAIN with the remote computer's // domain. You can also use kerberose instead // of ntdlmdomain. */ // Make a connection to a remote computer. // Replace the "FullComputerName" section of the // string "\\\\FullComputerName\\root\\cimv2" with // the full computer name or IP address of the // remote computer. ManagementScope scope = new ManagementScope( "\\\\FullComputerName\\root\\cimv2"); scope.Connect(); // Use this code if you are connecting with a // different user name and password: // // ManagementScope scope = // new ManagementScope( // "\\\\FullComputerName\\root\\cimv2", options); // scope.Connect(); //Query system for Operating System information ObjectQuery query = new ObjectQuery( "SELECT * FROM Win32_OperatingSystem"); ManagementObjectSearcher searcher = new ManagementObjectSearcher(scope,query); ManagementObjectCollection queryCollection = searcher.Get(); foreach ( ManagementObject m in queryCollection) { // Display the remote computer information Console.WriteLine("Computer Name : {0}", m["csname"]); Console.WriteLine("Windows Directory : {0}", m["WindowsDirectory"]); Console.WriteLine("Operating System: {0}", m["Caption"]); Console.WriteLine("Version: {0}", m["Version"]); Console.WriteLine("Manufacturer : {0}", m["Manufacturer"]); } } }
Inheritance Hierarchy
System.Object
System.Management.ManagementScope
Thread Safety
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.Platforms
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0See Also
Reference
Community Content
Thomas Lee
Incorrect Example Code
The example code above (both VB and C#) reference ntdlmdomain. That is incorrect. It should be ntlmdomain.
This:
ConnectionOptions options = new ConnectionOptions();
options.Authority = "ntdlmdomain:DOMAIN";
Should be:
ConnectionOptions options = new ConnectionOptions();
options.Authority = "ntlmdomain:DOMAIN";
This:
ConnectionOptions options = new ConnectionOptions();
options.Authority = "ntdlmdomain:DOMAIN";
Should be:
ConnectionOptions options = new ConnectionOptions();
options.Authority = "ntlmdomain:DOMAIN";