Classe Win32_TSAccount
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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de