Compartilhar via

Classe Win32_TSAccount

  • Artigo

A classe WMI Win32_TSAccount permite a exclusão de uma conta que existe no Win32_Terminal e a modificação das permissões existentes.

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, overwrite, provider("Win32_WIN32_TSACCOUNT_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_TSAccount : Win32_TerminalSetting
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  string   TerminalName;
  string   AccountName;
  uint32   AuditFail;
  uint32   AuditSuccess;
  uint32   PermissionsAllowed;
  uint32   PermissionsDenied;
  string   SID;
};

Membros

A classe Win32_TSAccount tem estes tipos de membros:

Métodos

A classe Win32_TSAccount tem esses métodos.

Método Descrição
Excluir Exclui a conta de usuário, grupo ou computador especificada.
ModifyAuditPermissions Altera a granularidade do conjunto de permissões de auditoria da conta especificada.
ModifyPermissions Define um conjunto de permissões mais granular para a conta especificada.

Propriedades

A classe Win32_TSAccount tem essas propriedades.

AccountName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: chave

O nome atual da conta. O nome de domínio está incluído.

AuditFail

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica as Permissões dos Serviços de Host da Sessão da Área de Trabalho Remota auditadas para uma condição de falha. O valor dessa propriedade é uma máscara de bits, que pode ser definida como um ou mais dos valores da propriedade PermissionsAllowed .

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4 (2)

WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)

WINSTATION_SHADOW=0x10 (4)

WINSTATION_LOGON=0x20 (5)

WINSTATION_MSG=0x80 (6)

WINSTATION_CONNECT=0x100 (7)

WINSTATION_DISCONNECT=0x200 (8)

AuditSuccess

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica as permissões específicas do servidor host da sessão rd que são auditadas para uma condição de êxito. O valor dessa propriedade é uma máscara de bits, que pode ser definida como um ou mais dos valores da propriedade PermissionsAllowed .

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (2)

WINSTATION_SHADOW=0x10 (3)

WINSTATION_LOGON=0x20 (4)

WINSTATION_MSG=0x80 (5)

WINSTATION_CONNECT=0x100 (6)

WINSTATION_DISCONNECT=0x200 (7)

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.

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.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

O nome do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

PermissionsAllowed

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica as Permissões de Serviços de Área de Trabalho Remota permitidas para a conta. O valor dessa propriedade é uma máscara de bits, que pode ser definida como um ou mais dos valores a seguir.

WINSTATION_QUERY=0x1 (1)

Permissão para consultar informações sobre uma sessão.

WINSTATION_SET (2)

Permissão para modificar parâmetros de conexão.

WINSTATION_RESET (64)

Permissão para redefinir ou encerrar uma sessão ou conexão.

WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED (983048)

Permissão para usar canais virtuais. Os canais virtuais fornecem acesso de um programa de servidor a dispositivos cliente.

WINSTATION_SHADOW (16)

Permissão para sombrear ou controlar remotamente a sessão de outro usuário.

WINSTATION_LOGON (32)

Permissão para fazer logon em uma sessão no servidor.

WINSTATION_LOGOFF (4)

Permissão para fazer logoff de um usuário de uma sessão.

WINSTATION_MSG (128)

Permissão para enviar uma mensagem para a sessão de outro usuário.

WINSTATION_CONNECT (256)

Permissão para se conectar a outra sessão.

WINSTATION_DISCONNECT (512)

Permissão para desconectar uma sessão.

PermissionsDenied

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Especifica as permissões específicas do servidor host de sessão de área de trabalho remota não permitidas para a conta. O valor dessa propriedade é uma máscara de bits, que pode ser definida como um ou mais dos valores da propriedade PermissionsAllowed .

WINSTATION_QUERY=0x1 (0)

WINSTATION_SET=0x2 (1)

WINSTATION_LOGOFF=0x4 (2)

WINSTATION_VIRTUAL | STANDARD_RIGHTS_REQUIRED = 0xF008 (3)

WINSTATION_SHADOW=0x10 (4)

WINSTATION_LOGON=0x20 (5)

WINSTATION_MSG=0x80 (6)

WINSTATION_CONNECT=0x100 (7)

WINSTATION_DISCONNECT=0x200 (8)

SID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Especifica os Identificadores de Segurança da conta.

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")

("Falha de Pred")

("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

Para se conectar ao namespace \root\CIMV2\TerminalServices, o nível de autenticação deve incluir privacidade de pacotes. Para chamadas C/C++, esse seria um nível de autenticação de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para o Visual Basic e chamadas de script, esse seria um nível de autenticação de WbemAuthenticationLevelPktPrivacy ou "pktPrivacy", com um valor de 6. O exemplo do Visual Basic Scripting Edition (VBScript) a seguir 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_TerminalSetting