Create method of the Win32_TSGatewayConnectionAuthorizationPolicy class

Article
06/13/2023

Crée une stratégie d’autorisation de connexion Bureau à distance à l’aide des valeurs spécifiées. Le nouveau cap des services Bureau à distance sera inséré en haut de l’ordre d’évaluation de LA CAP bureau à distance, avec la valeur de la propriété Order « 1 ».

Syntaxe

uint32 Create(
  [in] string  Name,
  [in] string  UserGroupNames,
  [in] string  ComputerGroupNames,
  [in] boolean SmartCard,
  [in] boolean Password,
  [in] boolean SecureId,
  [in] boolean Enabled,
  [in] uint32  DeviceRedirectionType,
  [in] boolean DiskDrivesDisabled,
  [in] boolean PrintersDisabled,
  [in] boolean SerialPortsDisabled,
  [in] boolean ClipboardDisabled,
  [in] boolean PlugAndPlayDevicesDisabled,
  [in] uint32  IdleTimeout,
  [in] uint32  SessionTimeout,
  [in] uint32  SessionTimeoutAction,
  [in] boolean AllowOnlySDRServers,
  [in] boolean CookieAuthentication
);

Paramètres

Nom [in]

Nom du cap des services Bureau à distance. Le nom doit comporter 64 caractères ou moins, unique (la casse est ignorée) et ne peut pas contenir les caractères réservés suivants :

<> : ; " / \ | ? * [TAB]

UserGroupNames [in]

Liste des noms de groupes d’utilisateurs, séparés par des points-virgules, pour le nouveau cap bureau à distance.

ComputerGroupNames [in]

Liste des noms de groupes d’ordinateurs, séparés par des points-virgules, pour le nouveau contrôle d’accès bureau à distance.

Carte à puce [in]

Spécifie si les cartes à puce peuvent être utilisées pour s’authentifier auprès du serveur de passerelle Bureau à distance.

Mot de passe [in]

Spécifie si les mots de passe peuvent être utilisés pour s’authentifier auprès du serveur de passerelle Bureau à distance.

SecureId [in]

Ce paramètre est réservé à un usage futur.

Activé [in]

Spécifie si cette cap des services Bureau à distance est activée.

DeviceRedirectionType [in]

Spécifie les types d’appareils qui seront redirigés.

0

Tous les appareils seront redirigés.

1

Aucun appareil ne sera redirigé.

2

Les appareils spécifiés ne seront pas redirigés. Les paramètres DiskDrivesDisabled, PrintersDisabled, SerialPortsDisabled, Presse-papiersDisabled et PlugAndPlayDevicesDisabled contrôlent les appareils qui ne seront pas redirigés.

DiskDrivesDisabled [in]

Spécifie s’il faut désactiver la redirection du lecteur de disque si le paramètre DeviceRedirectionType est « 2 ».

ImprimantesDisabled [in]

Spécifie s’il faut désactiver la redirection d’imprimante si le paramètre DeviceRedirectionType est « 2 ».

SerialPortsDisabled [in]

Spécifie s’il faut désactiver la redirection de port série si le paramètre DeviceRedirectionType est « 2 ».

Presse-papiersDisabled [in]

Spécifie s’il faut désactiver la redirection du Presse-papiers si le paramètre DeviceRedirectionType est « 2 ».

PlugAndPlayDevicesDisabled [in]

Spécifie s’il faut désactiver la redirection des appareils Plug-and-Play si le paramètre DeviceRedirectionType est « 2 ».

IdleTimeout [in]

Valeur du délai d’inactivité en minutes

SessionTimeout [in]

Valeur du délai d’expiration de session en minutes

SessionTimeoutAction [in]

Action de délai d’expiration de session en minutes

AllowOnlySDRServers [in]

Si les connexions sont autorisées uniquement aux serveurs TS SDR

CookieAuthentication [in]

Indique si l’authentification par cookie peut être utilisée pour se connecter au serveur de passerelle TS

Valeur retournée

Si la méthode réussit, elle retourne zéro. Si la méthode échoue, elle retourne une valeur différente de zéro. Pour obtenir la liste des codes d’erreur, consultez Codes d’erreur du fournisseur WMI des services Bureau à distance.

Notes

Vous devez être membre du groupe Administrateurs pour appeler cette méthode.

Les fichiers MOF (Managed Object Format) contiennent les définitions des classes WMI (Windows Management Instrumentation). Les fichiers MOF ne sont pas installés dans le cadre du Kit de développement logiciel (SDK) Microsoft Windows. Ils sont installés sur le serveur lorsque vous ajoutez le rôle associé à l’aide du Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez Managed Object Format (MOF).

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Root\CIMv2\TerminalServices
MOF	TSGateway.mof
DLL	AagWmi.dll

Voir aussi

Win32_TSGatewayConnectionAuthorizationPolicy

Partager via