{"id":66363,"date":"2006-09-29T14:51:00","date_gmt":"2006-09-29T14:51:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2006\/09\/29\/how-can-i-determine-whether-terminal-services-is-enabled-on-a-windows-server-2003-computer\/"},"modified":"2006-09-29T14:51:00","modified_gmt":"2006-09-29T14:51:00","slug":"how-can-i-determine-whether-terminal-services-is-enabled-on-a-windows-server-2003-computer","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/how-can-i-determine-whether-terminal-services-is-enabled-on-a-windows-server-2003-computer\/","title":{"rendered":"How Can I Determine Whether Terminal Services is Enabled on a Windows Server 2003 Computer?"},"content":{"rendered":"

\"Hey, \n

Hey, Scripting Guy! How can I determine whether Terminal Services is enabled on a Windows Server 2003 computer?

— DD<\/P>\"Spacer\"\"Hey,\"Script<\/A> \n

Hey, DD. You know, it turns out to be true: good things will<\/I> come to those who wait. According to the front page of The Seattle Times<\/I>, people who are grouchy and cantankerous today are more likely to be considered wiser and more intelligent when they get older. If that\u2019s true, and if we project his current level of grouchiness forward, in another 30 years or the Scripting Guy who writes this column should be working on his third or fourth Nobel Prize. Vindication at last!<\/P>\n

What that also means, DD, is this: if you\u2019re willing to wait another 30 years or so we could give you a very wise, very intelligent answer to your question. If you aren\u2019t<\/I> willing to wait, then you\u2019ll have to settle for this:<\/P>

strComputer = “.”<\/p>\n
Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/p>\n
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_TerminalServiceSetting”)<\/p>\n
For Each objItem in colItems\n    If objItem.AllowTSConnections = 0 Then\n        strStatus = “Disabled”\n    Else\n        strStatus = “Enabled”\n    End If\n    Wscript.Echo “Terminal Services status: ” & strStatus\nNext\n<\/PRE>\n
As you can see, there really isn\u2019t much to this script. We start out, as we usually do, by connecting to the WMI service on the local computer. Fortunately, this script can be easily modified to connect to the WMI service on a remote computer; after all, you probably don\u2019t need to go to all the trouble of writing a script in order to determine whether Terminal Services is enabled on your local machine. To connect to a remote computer using this script \u2013 or pretty much any other WMI script you\u2019ll find in the Script Center \u2013 just assign the name of that remote machine to the variable strComputer. For example, this line of code results in the script connecting to the WMI service on the computer atl-ts-01:<\/P>
strComputer = “atl-ts-01”\n<\/PRE>\n
Needless to say, the ability to do remotely pretty much everything you can do locally is one of the cooler features of WMI.<\/P>\n
After making the connection we use the following query to retrieve all the instances of the Win32_TerminalServiceSetting<\/B> class:<\/P>
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_TerminalServiceSetting”)\n<\/PRE>\n\n<\/THEAD>\n\n\n
\n
Note<\/B>. This is probably a good time to mention that the Win32_TerminalServiceSetting class is only available on computers running Windows Server 2003 or Windows XP. Among other things, that means this script can\u2019t be used to determine if Terminal Services is enabled on a Windows 2000 computer. That shouldn\u2019t be a problem for you, DD; you specifically asked about Terminal Services on Windows Server 2003. But it\u2019s something for other people to keep in mind.<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
<\/DIV>\n
After we run the query we\u2019ll get back a collection of all the Terminal Services settings for the computer in question. Although there will be only one item in the collection (that is, one group of Terminal Services settings), this is<\/I> a collection; that means we still need to set up a For Each loop in order to get at the individual items and property values. In particular, we want to examine the value of the AllowTSConnections<\/B> property, something we do here:<\/P>
If objItem.AllowTSConnections = 0 Then\n<\/PRE>\n
If AllowTSConnections is equal to 0 that means Terminal Services is disabled; if AllowTSConnections is equal to 1 that means Terminal Services in enabled. All we do in the remainder of the script is check the value of AllowTSConnections and then, based on that value, assign the string Disabled<\/I> or Enabled<\/I> to a variable named strStatus. We then use this line of code to echo back the Terminal Services status:<\/P>
Wscript.Echo “Terminal Services status: ” & strStatus\n<\/PRE>\n
That\u2019s all there is to it.<\/P>\n
Wait, wait: don\u2019t say it. You were just about to ask if it\u2019s possible to use a script to enable or disable Terminal Services, weren\u2019t you? (Hmmm, maybe there is<\/I> something to this correlation between grouchiness and intelligence.) You bet you can: all you have to do is call the SetAllowTSConnections<\/B> method, passing the method one of two possible parameters:<\/P>\n\n\n\n\n
\u2022<\/TD>\n\n
0<\/B>, to disable Terminal Services.<\/P><\/TD><\/TR>\n
\u2022<\/TD>\n\n
1<\/B>, to enable Terminal Services.<\/P><\/TD><\/TR><\/TBODY><\/TABLE>\n
For example, this script enables Terminal Services on the local computer:<\/P>
strComputer = “.”<\/p>\n
Set objWMIService = GetObject(“winmgmts:\\\\” & strComputer & “\\root\\cimv2”)<\/p>\n
Set colItems = objWMIService.ExecQuery _\n    (“Select * from Win32_TerminalServiceSetting”)<\/p>\n
For Each objItem in colItems\n    objItem.SetAllowTSConnections(1)\nNext\n<\/PRE>\n
You know, you\u2019re right: that was<\/I> pretty nice of us to give you a bonus script, wasn\u2019t it? Especially for as grouchy and cantankerous an old coot as the Scripting Guy who writes this column is. But we\u2019re going to let you in on a little secret: the Scripting Guy who writes this column is nowhere near as grouchy and hard-to-deal-with as his reputation would suggest. Instead, like many great figures in history, he\u2019s just a little misunderstood. <\/P>\n
Yes, just like the Roman emperor Caligula; Attila the Hun; Jack the Ripper; and, of course, Rasputin, the Mad Monk.<\/P><\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! How can I determine whether Terminal Services is enabled on a Windows Server 2003 computer?— DD Hey, DD. You know, it turns out to be true: good things will come to those who wait. According to the front page of The Seattle Times, people who are grouchy and cantankerous today are more […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3,130,722,5],"class_list":["post-66363","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-servers","tag-terminal-server","tag-vbscript"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! How can I determine whether Terminal Services is enabled on a Windows Server 2003 computer?— DD Hey, DD. You know, it turns out to be true: good things will come to those who wait. According to the front page of The Seattle Times, people who are grouchy and cantankerous today are more […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/66363","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=66363"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/66363\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=66363"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=66363"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=66363"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}