classe Win32_Terminal

La classe WMI Win32_Terminal rappresenta un terminale.

La sintassi seguente è semplificata dal codice MOF e include tutte le proprietà definite e ereditate, in ordine alfabetico. Per informazioni di riferimento sui metodi, vedere la tabella dei metodi più avanti in questo argomento.

Sintassi

[dynamic, overwrite, provider("Win32_WIN32_TERMINAL_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer\\WinStations"), AMENDMENT]
class Win32_Terminal : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint32   fEnableTerminal;
  uint32   LoggedOnUsers;
  string   TerminalName;
};

Members

La classe Win32_Terminal ha questi tipi di membri:

• Metodi
• Proprietà

Metodi

La classe Win32_Terminal dispone di questi metodi.

Metodo	Descrizione
Creare	Crea un terminale con impostazioni predefinite che possono essere personalizzate usando le proprietà e i metodi delle classi Win32_TerminalSetting .
Elimina	Elimina il terminale specificato.
Abilita	Disabilita o abilita il terminale.
Rinominare	Rinomina il terminale.

Proprietà

La classe Win32_Terminal ha queste proprietà.

Didascalia

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (64)

Breve descrizione (stringa a una riga) dell'oggetto .

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Descrizione

Tipo di dati: string

Tipo di accesso: sola lettura

Descrizione dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

fEnableTerminal

Tipo di dati: uint32

Tipo di accesso: sola lettura

Specifica se il terminale specificato è disabilitato o abilitato.

FALSE (0)

Il terminale è disabilitato.

TRUE (1)

Il terminale è abilitato.

InstallDate

Tipo di dati: datetime

Tipo di accesso: sola lettura

Qualificatori: mappingstringi ("MIF. DMTF| ComponentID|001.5")

Data di installazione dell'oggetto. La mancanza di un valore non indica che l'oggetto non è installato.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

LoggedOnUsers

Tipo di dati: uint32

Tipo di accesso: sola lettura

Numero di sessioni di accesso per il terminale.

Nome

Tipo di dati: string

Tipo di accesso: sola lettura

Nome dell'oggetto.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

Status

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: MaxLen (10)

Stato corrente dell'oggetto. È possibile definire vari stati operativi e non operativi. Gli stati operativi includono: "OK", "Degraded" e "Pred Fail" (un elemento, ad esempio un'unità disco rigido abilitata per SMART, potrebbe funzionare correttamente, ma prevedere un errore nel prossimo futuro). Gli stati non operativi includono: "Error", "Starting", "Stopping" e "Service". Quest'ultimo, "Servizio", può essere applicato durante il ridimensionamento mirror di un disco, il ricaricamento di un elenco di autorizzazioni utente o altre operazioni amministrative. Non tutto questo lavoro è on-line, ma l'elemento gestito non è "OK" né in uno degli altri stati.

Questa proprietà viene ereditata da CIM_ManagedSystemElement.

("OK")

("Errore")

("Danneggiato")

("Sconosciuto")

("Pred Fail")

("Avvio")

("Arresto")

("Servizio")

TerminalName

Tipo di dati: string

Tipo di accesso: sola lettura

Qualificatori: chiave

Nome univoco che identifica l'istanza del terminale.

Commenti

Win32_Terminal è associato a Win32_TerminalSetting come proprietà Element dell'associazione Win32_TerminalTerminalSetting .

Le classi seguenti sono sottoclassi della classe Win32_Terminal : Win32_TSGeneralSetting, Win32_TSLogonSetting, Win32_TSSessionSetting, Win32_TSEnvironmentSetting, Win32_TSRemoteControlSetting, Win32_TSClientSetting, Win32_TSNetworkAdapterSetting, Win32_TSNetworkAdapterListSetting, Win32_TSPermissionsSetting e Win32_TSAccount.

Si noti che le winstation associate alla sessione della console non possono accedere ai metodi e alle proprietà di questa classe. Se si tenta di eseguire questa operazione specificando "Console" come valore della proprietà TerminalName , i metodi di questo oggetto restituiscono WBEM_E_NOT_SUPPORTED. Questo codice di errore viene restituito anche se una stazione finestra tenta di chiamare metodi di questo oggetto per aggiungere o modificare le proprietà di sicurezza degli account LocalSystem, LocalService o NetworkService.

Per connettersi allo spazio dei nomi \root\CIMV2\TerminalServices, il livello di autenticazione deve includere la privacy dei pacchetti. Per le chiamate C/C++, si tratta di un livello di autenticazione di RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Per le chiamate a Visual Basic e scripting, si tratta di un livello di autenticazione di WbemAuthenticationLevelPktPrivacy o "pktPrivacy", con un valore pari a 6. Nell'esempio seguente di Visual Basic Scripting Edition (VBScript) viene illustrato come connettersi a un computer remoto con privacy dei pacchetti.

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

I file MOF (Managed Object Format) contengono le definizioni per le classi WMI (Windows Management Instrumentation). I file MOF non vengono installati come parte di Microsoft Windows Software Development Kit (SDK). Vengono installati nel server quando si aggiunge il ruolo associato usando il Server Manager. Per altre informazioni sui file MOF, vedere Managed Object Format (MOF).

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Spazio dei nomi	Root\CIMv2\TerminalServices
MOF	TSCfgWmi.mof
DLL	TSCfgWmi.dll

Vedi anche

CIM_LogicalElement

Win32_TerminalServiceSetting

Win32_TerminalTerminalSetting