Compartilhar via


classe Win32_TSNetworkAdapterSetting

A classe WMI Win32_TSNetworkAdapterSetting define várias configurações para a classe Win32_Terminal , incluindo propriedades relacionadas ao adaptador de rede e o número máximo de conexões permitidas.

A sintaxe a seguir é simplificada do código MOF e inclui todas as propriedades definidas e herdadas, em ordem alfabética. Para obter informações de referência sobre métodos, consulte a tabela de métodos mais adiante neste tópico.

Sintaxe

[dynamic, provider("Win32_WIN32_TSNETWORKADAPTERSETTING_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSNetworkAdapterSetting : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  string   DeviceIDList[];
  uint32   MaximumConnections;
  string   NetworkAdapterID;
  uint32   NetworkAdapterLanaID;
  string   NetworkAdapterList[];
  string   NetworkAdapterName;
  uint32   PolicySourceMaximumConnections;
};

Membros

A classe Win32_TSNetworkAdapterSetting tem esses tipos de membros:

Métodos

A classe Win32_TSNetworkAdapterSetting tem esses métodos.

Método Descrição
SelectAllNetworkAdapters Seleciona todos os adaptadores de rede.
SelectNetworkAdapterIP Seleciona um adaptador de rede com base no endereço IP do adaptador.
SetNetworkAdapterLanaID Especifica o número LANA (Adaptador de Rede local) netBIOS do adaptador de rede a ser definido.

Propriedades

A classe Win32_TSNetworkAdapterSetting tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64)

Descrição curta (cadeia de caracteres de uma linha) do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DeviceIDList

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Matriz de cadeia de caracteres de IDs de dispositivo disponíveis retornadas na ordem dos adaptadores de rede físicos retornados na matriz de propriedades NetworkAdapterList . O valor da ID do dispositivo é a propriedade DeviceID no Win32_NetworkAdapter

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: Mappingstrings ("MIF. DMTF| ComponentID|001.5")

A data em que o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

MaximumConnections

Tipo de dados: uint32

Tipo de acesso: leitura/gravação

O número máximo de conexões permitidas. O valor MAXINT indica um número ilimitado de conexões.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

NetworkAdapterID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O GUID que representa a ID do adaptador de rede a ser definido. Um GUID que consiste em todos os zeros indica todos os adaptadores de rede.

NetworkAdapterLanaID

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Número lana (adaptador de rede local) netbios do adaptador de rede que é usado para identificar o adaptador de rede atribuído ao terminal.

NetworkAdapterList

Tipo de dados: matriz de cadeia de caracteres

Tipo de acesso: Somente leitura

Matriz de cadeia de caracteres de adaptadores de rede física disponíveis e as IDs de dispositivo correspondentes. As IDs do dispositivo são a propriedade DeviceID em Win32_NetworkAdapter.

NetworkAdapterName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição do adaptador de rede a ser definido. Esse valor está em Win32_NetworkAdapterConfiguration.

PolicySourceMaximumConnections

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Indica se a propriedade MaximumConnections está configurada pelo servidor, pela política de grupo ou por padrão.

0

Servidor

1

Política de grupo

2

Padrão

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10)

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho resilvering de um disco, recarregamento de uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está on-line, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

("OK")

("Erro")

("Degradado")

("Desconhecido")

("Pred Fail")

("Iniciando")

("Parando")

("Serviço")

TerminalName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do terminal.

Essa propriedade é herdada de Win32_TerminalSetting.

Comentários

Lembre-se de que os Winstations associados à sessão do console não podem acessar os métodos e as propriedades dessa classe. Se for feita uma tentativa de fazer isso especificando "Console" como o valor da propriedade TerminalName, os métodos desse objeto retornarão WBEM_E_NOT_SUPPORTED. Esse código de erro também será retornado se uma estação de janela tentar chamar métodos desse objeto para adicionar ou modificar as propriedades de segurança das contas LocalSystem, LocalService ou NetworkService.

Para se conectar ao namespace "Root\CIMV2\TerminalServices", o nível de autenticação deve incluir privacidade de pacotes. Para chamadas C/C++, esse é um nível de autenticação de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para o Visual Basic e chamadas de script, esse é um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de 6. O exemplo a seguir do Visual Basic Scripting Edition (VBScript) mostra como se conectar a um computador remoto com privacidade de pacotes.

strComputer = "RemoteServer1" 
Set objServices = GetObject( _
    "winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")

Os arquivos MOF (Managed Object Format) contêm as definições para classes WMI (Instrumentação de Gerenciamento do Windows). Os arquivos MOF não são instalados como parte do SDK (Software Development Kit) do Microsoft Windows. Eles são instalados no servidor quando você adiciona a função associada usando o Gerenciador do Servidor. Para obter mais informações sobre arquivos MOF, consulte MOF (Managed Object Format).

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMv2\TerminalServices
MOF
TSCfgWmi.mof
DLL
TSCfgWmi.dll

Confira também

Win32_NetworkAdapter

Win32_NetworkAdapterConfiguration

Win32_TerminalSetting

Win32_TSNetworkAdapterListSetting