Win32_TSSessionDirectory clase
Define los valores de configuración del Agente de conexión a Escritorio remoto (Agente de conexión a Escritorio remoto) para la clase Win32_TSSessionDirectorySetting .
Nota
En Windows Server 2008 R2, el nombre del Agente de sesión de Terminal Services (Agente de sesión de TS) se cambió a Agente de conexión a Escritorio remoto. Estas propiedades se aplican a todos los sistemas operativos compatibles a menos que se indique lo contrario.
La siguiente sintaxis se simplifica desde el código MOF e incluye todas las propiedades definidas y heredadas, en orden alfabético. Para obtener información de referencia sobre los métodos, consulte la tabla de métodos más adelante en este tema.
Sintaxis
[dynamic, provider("Win32_WIN32_TSSESSIONDIRECTORY_Prov"), ClassContext("local|hkey_local_machine\\SYSTEM\\CurrentControlSet\\Control\\TerminalServer"), AMENDMENT]
class Win32_TSSessionDirectory : CIM_Setting
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
string SessionDirectoryLocation;
uint32 PolicySourceSessionDirectoryLocation;
uint32 SessionDirectoryActive;
uint32 PolicySourceSessionDirectoryActive;
uint32 SessionDirectoryExposeServerIP;
uint32 PolicySourceSessionDirectoryExposeServerIP;
string SessionDirectoryClusterName;
uint32 PolicySourceLoadBalancing;
uint32 GetLoadBalancingState;
uint32 GetServerWeight;
uint32 PolicySourceSessionDirectoryClusterName;
string SessionDirectoryIPAddress;
uint32 GetTSRedirectorMode;
uint32 PolicySourceTSRedirectorMode;
};
Miembros
La clase Win32_TSSessionDirectory tiene estos tipos de miembros:
Métodos
La clase Win32_TSSessionDirectory tiene estos métodos.
| Método | Descripción |
|---|---|
| CreateUserDiskTemplate | Crea una plantilla de disco de usuario. |
| DisableUserVhd | Deshabilita un VHD de perfil de usuario. |
| EnableUserVhd | Habilita un VHD de perfil de usuario en un servidor RDSH. |
| GetCurrentRedirectableAddresses | Obtiene la lista configurada actualmente de direcciones aptas para DNS y el tipo de redireccionamiento. |
| GetRedirectableAddresses | Obtiene toda la lista de direcciones aptas para DNS. |
| PingSessionDirectory | Comprueba si el servidor del Agente de conexión a Escritorio remoto está disponible. |
| SetCurrentRedirectableAddresses | Establece la lista configurada de direcciones aptas para DNS y el tipo de redireccionamiento. |
| SetLoadBalancingState | Establece el valor para indicar si el servidor va a participar en el equilibrio de carga del Agente de conexión a Escritorio remoto. |
| SetServerWeight | Establece el valor de peso del servidor para el equilibrio de carga del Agente de conexión a Escritorio remoto. |
| SetSessionDirectoryActive | Deshabilita y habilita el agente de conexión a Escritorio remoto. |
| SetSessionDirectoryExposeServerIP | Establece la propiedad SessionDirectoryExposeServerIP . |
| SetSessionDirectoryProperty | Establece la propiedad SessionDirectoryLocation o la propiedad SessionDirectoryClusterName . |
| SetTSRedirectorMode | Este método no está disponible. |
Propiedades
La clase Win32_TSSessionDirectory tiene estas propiedades.
-
Caption
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (64)
Descripción corta (cadena de una línea) del objeto .
Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
Descripción
-
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
Descripción del objeto .
Esta propiedad se hereda de CIM_ManagedSystemElement.
-
-
GetLoadBalancingState
-
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor está configurado para participar en el equilibrio de carga del Agente de conexión a Escritorio remoto.
-
-
0
-
El servidor no está configurado para participar en el equilibrio de carga del Agente de conexión a Escritorio remoto.
-
1
-
El servidor está configurado para participar en el equilibrio de carga del Agente de conexión a Escritorio remoto.
GetServerWeight
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Recupera el valor de peso del servidor que se usa en el equilibrio de carga del Agente de conexión a Escritorio remoto.
GetTSRedirectorMode
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor está configurado para que actúe como un redirector de Servicios de Escritorio remoto.
0
El servidor está configurado para que actúe como un redirector de Servicios de Escritorio remoto.
1
El servidor no está configurado para actuar como un redirector de Servicios de Escritorio remoto.
Windows Server 2008: Esta propiedad no está disponible.
InstallDate
-
Tipo de datos: datetime
-
Tipo de acceso: solo lectura
-
Calificadores: Mappingstrings ("MIF. DMTF| ComponentID|001.5")
Fecha en que se instaló el objeto. La falta de un valor no indica que el objeto no está instalado.
Esta propiedad se hereda de CIM_ManagedSystemElement.
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
El nombre del objeto.
Esta propiedad se hereda de CIM_ManagedSystemElement.
PolicySourceLoadBalancing
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor o la directiva de grupo configuran la propiedad GetLoadBalancingState .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
PolicySourceSessionDirectoryActive
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor o la directiva de grupo configuran la propiedad SessionDirectoryActive .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
PolicySourceSessionDirectoryClusterName
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor o la directiva de grupo configuran la propiedad SessionDirectoryClusterName .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
PolicySourceSessionDirectoryExposeServerIP
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor o la directiva de grupo configuran la propiedad SessionDirectoryExposeServerIP .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
PolicySourceSessionDirectoryLocation
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Indica si el servidor o la directiva de grupo configuran la propiedad SessionDirectoryLocation .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
PolicySourceTSRedirectorMode
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Esta propiedad no está disponible.
Windows Server 2008 R2: Indica si el servidor o la directiva de grupo configuran la propiedad GetTSRedirectorMode .
0 (0x0)
Servidor
1 (0x1)
Directiva de grupo
SessionDirectoryActive
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
-
Calificadores: key
Especifica si los Servicios de Escritorio remoto participan en el Agente de conexión a Escritorio remoto.
FALSE (0)
La participación de Servicios de Escritorio remoto en el Agente de conexión a Escritorio remoto está deshabilitada.
TRUE (1)
La participación de Servicios de Escritorio remoto en el Agente de conexión a Escritorio remoto está habilitada.
SessionDirectoryClusterName
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
La dirección IP virtual del clúster al que pertenece el servidor host de sesión de Escritorio remoto.
SessionDirectoryExposeServerIP
-
Tipo de datos: uint32
-
Tipo de acceso: solo lectura
Especifica si se permite la recuperación de la dirección IP del agente de conexión a Escritorio remoto.
FALSE (0)
Se deniega la recuperación.
TRUE (1)
Se permite la recuperación.
SessionDirectoryIPAddress
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
La dirección IP del adaptador laN utilizado por el directorio de sesión.
SessionDirectoryLocation
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
El nombre DNS de red o la dirección IP del servidor donde se ejecuta el servicio agente de conexión a Escritorio remoto.
Estado
-
Tipo de datos: cadena
-
Tipo de acceso: solo lectura
-
Calificadores: MaxLen (10)
Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Pred Fail" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Starting", "Stopping" y "Service". Este último, "Servicio", podría aplicarse durante la reestablecimiento de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "OK" ni en uno de los otros estados.
Esta propiedad se hereda de CIM_ManagedSystemElement.
("Ok")
("Error")
("Degradado")
("Desconocido")
("Error previo")
("Starting")
("Detener")
("Servicio")
Observaciones
Para conectarse al espacio de nombres \\root\CIMV2\TerminalServices, el nivel de autenticación debe incluir la privacidad del paquete. En el caso de las llamadas de C/C++, se trata de un nivel de autenticación de RPC_C_AUTHN_LEVEL_PKT_PRIVACY. Para las llamadas de Visual Basic y scripting, se trata de un nivel de autenticación de WbemAuthenticationLevelPktPrivacy o "pktPrivacy", con un valor de seis.
En el siguiente ejemplo de Visual Basic Scripting Edition (VBScript) se muestra cómo conectarse a un equipo remoto con privacidad de paquetes.
strComputer = "RemoteServer1"
Set objServices = GetObject( _
"winmgmts:{authenticationLevel=pktPrivacy}!Root/CIMv2/TerminalServices")
En Windows Server 2008, el nombre de la característica directorio de sesión de Terminal Services se cambió a Terminal Services Session Broker.
En Windows Server 2008 R2, el nombre de la característica agente de sesión de Terminal Services se cambió a Agente de conexión a Escritorio remoto.
Los archivos managed Object Format (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Los archivos MOF no se instalan como parte del Kit de desarrollo de software (SDK) de Microsoft Windows. Se instalan en el servidor cuando se agrega el rol asociado mediante el Administrador del servidor. Para obtener más información sobre los archivos MOF, vea Managed Object Format (MOF) (Formato de objeto administrado [MOF]).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
No se admite ninguno |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMv2\TerminalServices |
| MOF |
|
| Archivo DLL |
|