ConnectionOptions Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica todas as definições necessárias para fazer uma ligação WMI.
public ref class ConnectionOptions : System::Management::ManagementOptions
public class ConnectionOptions : System.Management.ManagementOptions
type ConnectionOptions = class
inherit ManagementOptions
Public Class ConnectionOptions
Inherits ManagementOptions
- Herança
Exemplos
O exemplo seguinte liga-se a um computador remoto e apresenta informações sobre o sistema operativo no computador remoto. O A ConnectionOptions é criado para se ligar ao computador remoto com as opções de ligação por defeito.
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.
// This example uses the default values.
ConnectionOptions options =
new ConnectionOptions();
// 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", 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"]);
}
}
}
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
' 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", 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
Construtores
| Name | Description |
|---|---|
| ConnectionOptions() |
Inicializa uma nova instância da ConnectionOptions classe para a operação de ligação, usando valores padrão. Este é o construtor sem parâmetros. |
| ConnectionOptions(String, String, SecureString, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan) |
Cria uma nova ConnectionOption. |
| ConnectionOptions(String, String, String, String, ImpersonationLevel, AuthenticationLevel, Boolean, ManagementNamedValueCollection, TimeSpan) |
Inicializa uma nova instância da ConnectionOptions classe a ser usada para uma ligação WMI, usando os valores especificados. |
Propriedades
| Name | Description |
|---|---|
| Authentication |
Obtém ou define o nível de autenticação COM a ser usado para operações nesta ligação. |
| Authority |
Obtém ou define a autoridade a ser usada para autenticar o utilizador especificado. |
| Context |
Obtém ou define um objeto de contexto WMI. Esta é uma lista de pares nome-valor a ser passada para um fornecedor WMI que suporta informação de contexto para operação personalizada. (Herdado de ManagementOptions) |
| EnablePrivileges |
Recebe ou define um valor que indica se os privilégios do utilizador precisam de ser ativados para a operação de ligação. Esta propriedade só deve ser usada quando a operação realizada exige que um certo privilégio de utilizador esteja ativado (por exemplo, um reinício da máquina). |
| Impersonation |
Obtém ou define o nível de personificação COM a ser usado para operações nesta ligação. |
| Locale |
Obtém ou define a localização a ser usada para a operação de ligação. |
| Password |
Define a palavra-passe para o utilizador especificado. |
| SecurePassword |
Define a palavra-passe para o utilizador especificado. |
| Timeout |
Obtém ou define o time-out para aplicar à operação. Note que, para operações que retornam coleções, este time-out aplica-se à enumeração através da coleção resultante, não à operação em si (a ReturnImmediately propriedade é usada para esta última). Esta propriedade é usada para indicar que a operação deve ser realizada de forma semi-síncrona. (Herdado de ManagementOptions) |
| Username |
Obtém ou define o nome de utilizador a ser usado para a operação de ligação. |
Métodos
| Name | Description |
|---|---|
| Clone() |
Devolve uma cópia do objeto. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |