{"id":65663,"date":"2007-01-25T00:27:00","date_gmt":"2007-01-25T00:27:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2007\/01\/25\/hey-scripting-guy-how-can-i-start-office-outlook-if-it-isnt-already-running\/"},"modified":"2007-01-25T00:27:00","modified_gmt":"2007-01-25T00:27:00","slug":"hey-scripting-guy-how-can-i-start-office-outlook-if-it-isnt-already-running","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-start-office-outlook-if-it-isnt-already-running\/","title":{"rendered":"Hey, Scripting Guy! How Can I Start Office Outlook If It Isn\u2019t Already Running?"},"content":{"rendered":"

\"Hey, <\/h2>\n

Hey, Scripting Guy! How can I determine if Office Outlook is running and, if it isn’t, start it?<\/p>\n

— NA<\/p>\n

\"Spacer\"\"Hey,\"Script<\/a><\/p>\n

Hey, NA. You know, this past weekend the Scripting Guy who writes this column found himself wandering through the local shopping mall, a turn of events which left him very uneasy, almost fearful. Why? Well, the last time he’d been in the mall (during the height of the Christmas shopping rush) he’d been meandering along when he was approached by a young woman who spoke with a very heavy French accent. Due to both the accent and the noise inside the mall, the Scripting Guy who writes this column had difficulty understanding her at first; he assumed, however, that the woman was asking for directions or something. Because of that he tried focusing very hard on what the woman was saying. She must have mistaken this concentration for intense interest, because the next thing he knew she had poured salt all over his hands and was pantomiming that the Scripting Guy should now thoroughly “wash” his hands with the salt.<\/p>\n

“Do you know which place on Earth has the lowest elevation?” she asked, a question which caught the Scripting Guy off guard. What, she needs directions to the Dead Sea<\/i>?<\/p>\n

“The Dead Sea?” replied the Scripting Guy.<\/p>\n

“Oh,” she said, a little disappointed. “No one ever gets that right. Yes, the Dead Sea, and this is salt taken directly from the Dead Sea. If you rub it all over your hands and then wash it off you’ll be amazed how smooth your skin will be. Your hands will be as soft as a baby’s bottom.”<\/p>\n

To her credit, she was right: once he got all the salt off, the Scripting Guy’s hands were<\/i> as soft as a baby’s bottom. That was great, too, except for one problem: the Scripting Guy who writes this column doesn’t want<\/i> his hands to be as soft as a baby’s bottom. Although he doesn’t consider himself a wimp, he apparently comes off<\/i> as a wimp; for example, any time he plays basketball or football the first thing people try to do is run right over the top of him. Obviously, people aren’t all that impressed with his manliness to begin with; the last thing he needs is baby-soft hands. But, at least for a few hours, he had them.<\/p>\n

We don’t know if you’re<\/i> interested in having soft hands, NA; if you are, Dead Sea salt seems to do the trick. But if all you care about is a script that can determine whether or not Outlook is running and, if not, start it, well, then this<\/i> should do the trick:<\/p>\n

Const olFolderInbox = 6\n\nstrComputer = \".\"\n\nSet objWMIService = GetObject(\"winmgmts:\\\\\" & strComputer & \"\\root\\cimv2\")\n\nSet colItems = objWMIService.ExecQuery _\n    (\"Select * From Win32_Process Where Name = 'outlook.exe'\")\n\nIf colItems.Count = 0 Then\n    Set objOutlook = CreateObject(\"Outlook.Application\")\n    Set objNamespace = objOutlook.GetNamespace(\"MAPI\")\n    objNamespace.Logon \"Default Outlook Profile\",, False, True    \n    Set objFolder = objNamespace.GetDefaultFolder(olFolderInbox)\n    objFolder.Display\nEnd If<\/pre>\n
We hope you can read that, NA; as it turns out, it’s hard to type with really soft hands. (Maybe that’s why babies don’t do much typing.) As you can see, we start out by defining a constant named olFolderInbox and setting the value to 6; we’ll use this constant when (or, more precisely, if<\/i>) we open Outlook. Following that we connect to the WMI service on the local computer, then use this line of code to return a collection of all the processes on the computer whose Name<\/b> property has the value outlook.exe<\/i>:<\/p>\n
Set colItems = objWMIService.ExecQuery _\n    (\"Select * From Win32_Process Where Name = 'outlook.exe'\")<\/pre>\n\n<\/thead>\n\n\n
\n
Note<\/b>. Good question: could<\/i> you run this script against a remote computer? Well, no, not really. You can easily determine whether or not Outlook is running on the remote machine, but you’ll run into problems when you try to start<\/i> Outlook on that remote computer. Why? Because, for security reasons, processes started remotely always run in an invisible window; you’ll be able to start<\/i> Outlook but you won’t be able see<\/i> Outlook onscreen. Are there ways to work around this issue? Well, sort of; take a peek at this Hey, Scripting Guy! column<\/b><\/a> for one suggestion.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
When we call the ExecQuery<\/b> method we get back a collection of all the processes running on the computer, or at least those processes that have the name Outlook.exe. To determine whether or not Outlook is running all we need to do is examine the value of the Count<\/b> property, which tells us the number of items in the collection. If the Count is equal to anything other than 0 that means Outlook is already running and our job is finished.<\/p>\n
But what if the Count is<\/i> 0? In that case, Outlook isn’t<\/i>, running; consequently, we need to use this block of code to start the application:<\/p>\n
Set objOutlook = CreateObject(\"Outlook.Application\")\nSet objNamespace = objOutlook.GetNamespace(\"MAPI\")\nobjNamespace.Logon \"Default Outlook Profile\",, False, True    \nSet objFolder = objNamespace.GetDefaultFolder(olFolderInbox)\nobjFolder.Display<\/pre>\n
This bit of code begins by creating an instance of the Outlook.Application<\/b> object, then binds to the MAPI<\/b> namespace, something you have to do even though this is the only<\/i> namespace you can bind to. From there we call the Logon<\/b> method, passing the following four parameters in order to ensure that we log on to the correct Outlook profile:<\/p>\n\n<\/thead>\n\n\n\n\n\n\n
\n
Parameter<\/b><\/p>\n<\/td>\n
\n
Description<\/b><\/p>\n<\/td>\n<\/tr>\n
\n
Profile<\/p>\n<\/td>\n
\n
Name of the Outlook profile we want to connect to. This sample script uses “Default Outlook Profile”.<\/p>\n<\/td>\n<\/tr>\n
\n
Password<\/p>\n<\/td>\n
\n
Optional password to be used when connecting. This parameter exists primarily for backwards compatibility purposes and will almost always be left blank.<\/p>\n<\/td>\n<\/tr>\n
\n
ShowDialog<\/p>\n<\/td>\n
\n
Specifies whether the profile selection dialog box should be shown. We’ve already indicated that we want to use Default Outlook Profile, so there’s no reason to show this dialog box. Thus we set the value to False.<\/p>\n<\/td>\n<\/tr>\n
\n
NewSession<\/p>\n<\/td>\n
\n
Specifies whether a new Outlook session should be created. Because Outlook isn’t running we obviously need to create a new session. Thus we set this parameter to True.<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
<\/div>\n
The rest is easy: we use the GetDefaultFolder<\/b> method to connect to the Inbox (using – at last! – the constant olFolderInbox) and then we call the Display<\/b> method to make the Inbox, and the rest of Outlook, visible on screen. That’s all we have to do.<\/p>\n
Incidentally, even though she was trying to sell him “beauty products” the Scripting Guy who writes this column actually felt sorry for the woman with the French accent; she couldn’t have picked a person less likely to buy – let alone use – Dead Sea salt. (At least not on his hands; maybe on his French fries.) “OK, so perhaps you aren’t concerned with smooth hands,” she said. “But let me ask you another question: what facial care products do you currently use?”<\/p>\n
“Water.”<\/p>\n
“No, no, I mean besides water.”<\/p>\n
“Uh, soap?”<\/p>\n
“Excuse me; I think someone over there has a question. Thank you for your time.”<\/p>\n","protected":false},"excerpt":{"rendered":"
Hey, Scripting Guy! How can I determine if Office Outlook is running and, if it isn’t, start it? — NA Hey, NA. You know, this past weekend the Scripting Guy who writes this column found himself wandering through the local shopping mall, a turn of events which left him very uneasy, almost fearful. Why? Well, […]<\/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":[212,49,3,5],"class_list":["post-65663","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-microsoft-outlook","tag-office","tag-scripting-guy","tag-vbscript"],"acf":[],"blog_post_summary":"
Hey, Scripting Guy! How can I determine if Office Outlook is running and, if it isn’t, start it? — NA Hey, NA. You know, this past weekend the Scripting Guy who writes this column found himself wandering through the local shopping mall, a turn of events which left him very uneasy, almost fearful. Why? Well, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/65663","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=65663"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/65663\/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=65663"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=65663"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=65663"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}