Win32_TSDeploymentSettings clase

Artículo
06/13/2023

Define la configuración predeterminada que el Administrador de RemoteApp usa al crear archivos de Protocolo de escritorio remoto (RDP). Esta configuración no afecta a las aplicaciones o escritorios publicados.

Sintaxis

class Win32_TSDeploymentSettings : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  sint32   Port;
  string   FarmName;
  sint32   GatewayUsage;
  string   GatewayName;
  sint32   GatewayAuthMode;
  boolean  GatewayUseCachedCreds;
  boolean  RequireServerAuth;
  sint32   ColorBitDepth;
  boolean  AllowFontSmoothing;
  boolean  UseMultimon;
  sint32   RedirectionOptions;
  boolean  HasCertificate;
  uint8    CertificateHash[];
  string   CertificateIssuedTo;
  string   CertificateIssuedBy;
  string   CertificateExpiresOn;
  string   CustomRDPSettings;
  string   DeploymentRDPSettings;
};

Miembros

La clase Win32_TSDeploymentSettings tiene estos tipos de miembros:

Propiedades

Propiedades

La clase Win32_TSDeploymentSettings tiene estas propiedades.

AllowFontSmoothing

Tipo de datos: booleano
Tipo de acceso: lectura/escritura

Indica si se va a permitir el suavizado de fuentes.

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.

CertificateExpiresOn

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Fecha en la que expira el certificado. Este valor se almacena como un formato FILETIME de 64 bits.

CertificateHash

Tipo de datos: matriz uint8
Tipo de acceso: lectura/escritura

Huella digital del certificado que se usa para firmar archivos RDP.

CertificateIssuedBy

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Especifica quién emite el certificado.

CertificateIssuedTo

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Especifica a quién se emite el certificado.

ColorBitDepth

Tipo de datos: sint32
Tipo de acceso: lectura/escritura

Profundidad de bits de color de la pantalla. Los valores posibles son 4, 8, 15, 16, 24 y 32.

CustomRDPSettings

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

El contenido del archivo RDP que corresponde a la configuración de RDP personalizada en RemoteApp Manager.

DeploymentRDPSettings

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Contenido del archivo RDP que corresponde a la configuración de implementación en RemoteApp Manager. Si se establece este valor, la configuración de implementación de RDP sustituye a la configuración predeterminada de esta clase. Por ejemplo, si establece la propiedad GatewayAuthMode en esta clase y establece la propiedad DeploymentRDPSettings , se omitirá la propiedad GatewayAuthMode de esta clase y se usará el valor GatewayAuthMode de DeploymentRDPSettings .

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción del objeto .

Esta propiedad se hereda de CIM_ManagedSystemElement.

FarmName

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

El nombre del servidor host de sesión de Escritorio remoto o el nombre de dominio completo (FQDN) de la granja de servidores host de sesión de Escritorio remoto.

GatewayAuthMode

Tipo de datos: sint32
Tipo de acceso: lectura/escritura

Método de autenticación de puerta de enlace de Escritorio remoto. Los siguientes valores son posibles.

0

Contraseña

1

Tarjeta inteligente

4

Permitir al usuario seleccionar durante la conexión.

GatewayName

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Nombre del servidor de puerta de enlace de Escritorio remoto que se va a usar.

GatewayUsage

Tipo de datos: sint32
Tipo de acceso: lectura/escritura

Indica si se debe usar un servidor de puerta de enlace de Escritorio remoto para conectarse al servidor host de sesión de Escritorio remoto de destino a través de un firewall. Los siguientes valores son posibles.

No use un servidor de puerta de enlace de Escritorio remoto.

Use un servidor de puerta de enlace de Escritorio remoto. Omita el servidor de puerta de enlace de Escritorio remoto para las direcciones locales.

Use un servidor de puerta de enlace de Escritorio remoto.

Detecte automáticamente la configuración del servidor de puerta de enlace de Escritorio remoto.

GatewayUseCachedCreds

Tipo de datos: booleano
Tipo de acceso: lectura/escritura

Cuando sea posible, use las mismas credenciales de usuario para el servidor de puerta de enlace de Escritorio remoto y el servidor host de sesión de Escritorio remoto.

HasCertificate

Tipo de datos: booleano
Tipo de acceso: lectura/escritura

Indica si se debe usar un certificado para firmar los archivos RDP.

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.

Puerto

Tipo de datos: sint32
Tipo de acceso: lectura/escritura

Puerto RDP que se va a usar.

RedirectionOptions

Tipo de datos: sint32
Tipo de acceso: lectura/escritura

Especifica las opciones de redirección de recursos y dispositivo para las conexiones de RemoteApp. Se pueden combinar marcas para RedirectionOptions . Los siguientes valores son posibles.

No hay redirección de dispositivos ni recursos.

Redireccione las unidades de disco.

Redirigir impresoras.

Redirija el Portapapeles.

Redirección de dispositivos Plug and Play compatibles.

Redirección de tarjetas inteligentes.

Redirección de audio.

Redirigir puertos serie.

RequireServerAuth

Tipo de datos: booleano
Tipo de acceso: lectura/escritura

Indica si se requiere autenticación del servidor.

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

UseMultimon

Tipo de datos: booleano
Tipo de acceso: lectura/escritura

Indica si hay varios monitores habilitados para el escritorio.

Observaciones

Debe ser miembro del grupo Administradores para establecer propiedades mediante esta clase.

Si RequireServerAuth está establecido en TRUE, tenga en cuenta lo siguiente:

Si el programa RemoteApp es para uso de intranet y todos los equipos cliente ejecutan Windows Server 2008 o Windows Vista, no es necesario configurar el servidor host de sesión de Escritorio remoto para usar un certificado SSL. En este caso, se usa la Autenticación a nivel de red.
Debe especificar el FQDN del servidor o granja de servidores para el valor de la propiedad FarmName .

Para conectarse al espacio de nombres "CIMV2\TerminalServices", el nivel de autenticación debe incluir privacidad de paquetes. Para las llamadas de C/C++, se trata de un nivel de autenticación de RPC_C_AUTHN_LEVEL_PKT_PRIVACY, que se puede establecer mediante la función COM CoSetProxyBlanket . En el caso de las llamadas de Visual Basic y scripting, se trata de un nivel de autenticación de WbemAuthenticationLevelPktPrivacy o "pktPrivacy", con un valor de 6. 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")

Los archivos managed Object Format (MOF) contienen las definiciones de clases de Instrumental de administración de Windows (WMI). Se instalan en el equipo al agregar el rol asociado. 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	Tsallow.mof
Archivo DLL	TsPubWmi.dll

Compartir a través de

Win32_TSDeploymentSettings clase

Sintaxis

Miembros

Propiedades

Observaciones

Requisitos

Comentarios

Recursos adicionales