Applies to: Exchange Server 2007 SP3, Exchange Server
2007 SP2, Exchange Server 2007 SP1
Topic Last Modified: 2008-07-24
This topic provides sample Visual Basic scripts that can be used as a starting point for creating the script files required to make a build DVD to improve the server build process. You can modify the following procedures to create the necessary scripts for your organization.
The following sample scripts must be modified in order to make them functional in your specific environment. These scripts can help you automate many of the steps required to deploy an Exchange server in your environment.
Sample Visual Basic Scripts
Important: |
---|
These scripts samples illustrate how automation steps can be implemented. You must modify them to make them appropriate for your environment. You must test everything in a lab environment prior to attempting to use them in your production environment. |
Before You Begin
To perform the following procedures, the account you use must be a member of the Local Administrators group.
For more information about permissions, delegating roles, and the rights that are required to administer Exchange 2007, see Permission Considerations.
LegacyEAS.vbs
Procedure
Use Notepad to create a Visual Basic script to enable Windows Integrated Authentication and Basic Authentication on the /Microsoft-Server-Activesync virtual directory on Exchange 2003 servers (within a defined administrative group)
-
Open Notepad or another text editor.
-
Copy the following code into a file and save the file with a descriptive name and the .bat extension. We recommend naming the file legacyEAS.vbs.
Copy Code #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!" #"!!!!!!! THIS IS NOT A MICROSOFT SUPPORTED SCRIPT. !!!!!!!!" #"!!!!!!! TEST IN A LAB FOR DESIRED OUTCOME !!!!!!!!" #"!!!!!!! !!!!!!!!!!" #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!" #" " '======================================='legacyEAS.vbs ' 'Copyright (c) 2007, Microsoft Corporation. All Rights Reserved. ' 'THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY 'KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE 'IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 'PARTICULAR PURPOSE. ' ' Description: This script will enable Windows Integrated Authentication and Basic Authentication ' on the /Microsoft-Server-Activesync virtual directory on Exchange 2003 servers ' within in a defined administrative group. ' 'Written by: Ross Smith IV (Microsoft) ' 'Version: 1.3 'Last Updated: 2/26/06 '======================================= '====================================================='Define Variables & Constants '===================================================== Option Explicit Dim oArg, cnADQuery, cmEASQuery, cmOrgQuery, rsOrgDN, rsEAS, oRootDSE, strConfigurationNC, objContainer Dim strAGName, strAttValue, strAttribute, strDomainController, strEASDN, strLDAPPath, strLDAPCNC, strOrgDN, strLDAPSDN Dim i, strRemoveVal Const ADS_SCOPE_BASE = 0 Const ADS_SCOPE_ONELEVEL = 1 Const ADS_SCOPE_SUBTREE = 2 Const ADS_PROPERTY_CLEAR = 1 Const ADS_PROPERTY_UPDATE = 2 Const ADS_PROPERTY_APPEND = 3 Const ADS_PROPERTY_DELETE = 4 '====================================================='Determine if CSCRIPT must be used '===================================================== if InStr(1,wscript.fullname,"cscript.exe",1) = 0 then wscript.echo "This script should be run using 'cscript.exe <scriptfile>'. Terminating script." wscript.quit end if '=====================================================' Clear and set string variables '===================================================== strAGName = "" strDomainController = "" strLDAPCNC = "" strLDAPSDN = "" strOrgDN = "" strEASDN = "" strConfigurationNC = "" strAttribute = "msExchAuthenticationFlags" strAttValue = "6" '=====================================================' Parse command-line arguments '===================================================== Set oArg = wscript.arguments if oArg.Count = 0 then ' we need the arguments DisplayHelpMessage wscript.quit End If For i = 0 to oArg.Count - 1 'Get Domain Contoller value If LCase(Left(oArg.Item(i),3)) = "-d:" then strDomainController = Mid(oArg.Item(i),4) 'wscript.echo strDomainController end if 'Get Administrative Group Name value If LCase(Left(oArg.Item(i),3)) = "-a:" then strAGName = Mid(oArg.Item(i),4) 'wscript.echo strAGName end if Next '=====================================================' Make sure AG argument has been passed '===================================================== If strAGName = "" then wscript.echo "A valid Administrative Group argument was not passed!" wscript.quit end if '=====================================================' Determine if Domain Controller argument was passed '===================================================== If strDomainController <> "" then strLDAPPath = "LDAP://" & strDomainController & "/" else strLDAPPath = "LDAP://" end if '=====================================================' Initialize any objects that need initialization '===================================================== Set cnADQuery = CreateObject("ADODB.Connection") Set cmEASQuery = CreateObject("ADODB.Command") Set cmOrgQuery = CreateObject("ADODB.Command") '=====================================================' Open the connection '===================================================== cnADQuery.Provider = "ADsDSOObject" ' This is the ADSI OLE-DB provider name cnADQuery.Open "Active Directory Provider" '=====================================================' Create command objects for this connection '===================================================== Set cmOrgQuery.ActiveConnection = cnADQuery Set cmEASQuery.ActiveConnection = cnADQuery '=====================================================' Get Configuration Naming Context & Build LDAP Path '===================================================== Set oRootDSE = GetObject(strLDAPPath & "RootDSE") strConfigurationNC = oRootDSE.Get("configurationNamingContext") 'wscript.echo strConfigurationNC strLDAPCNC = strLDAPPath & strConfigurationNC '=====================================================' Compose Search string & set search order ' for Exchange Organization Search '===================================================== cmOrgQuery.CommandText = "select distinguishedName from '" & strLDAPCNC & "' where objectCategory = 'msExchOrganizationContainer'" cmOrgQuery.Properties("searchscope") = ADS_SCOPE_SUBTREE 'Verification of CommandText 'wscript.echo "cmOrgQuery = " & cmOrgQuery.CommandText '=====================================================' Execute & Navigate Server Query '===================================================== Set rsOrgDN = cmOrgQuery.Execute if Err.Number <> 0 then wscript.echo "Could not locate the organization container!" wscript.quit end if while not rsOrgDN.EOF 'wscript.echo rsOrgDN.Fields("distinguishedName").value strOrgDN = rsOrgDN.Fields("distinguishedName").value rsOrgDN.MoveNext wend '=====================================================' Compose Search string & set search order ' for EAS vdir Search '===================================================== If strOrgDN = "" then wscript.echo "Could not locate the organization container!" wscript.quit else strLDAPSDN = strLDAPPath & "cn=" & strAGName & ",cn=Administrative Groups," & strOrgDN end if cmEASQuery.CommandText = "select name, distinguishedName from '" & strLDAPSDN & "' where cn = 'Microsoft-Server-Activesync'" cmEASQuery.Properties("searchscope") = ADS_SCOPE_SUBTREE 'Verification of CommandText 'wscript.echo "cmEASQuery = " & cmEASQuery.CommandText '=====================================================' Execute & Navigate SG Query '===================================================== Set rsEAS = cmEASQuery.Execute if Err.Number <> 0 then wscript.echo "The failed query was..." wscript.echo cmEASQuery.CommandText wscript.quit end if while not rsEAS.EOF 'wscript.echo rsEAS.Fields("distinguishedName").value 'wscript.echo rsEAS.Fields("name").value strEASDN = rsEAS.Fields("distinguishedName").value Set objContainer = GetObject(strLDAPPath & strEASDN) objContainer.Put strAttribute, strAttValue objContainer.SetInfo wscript.echo "Exchange Server Container DN - " & strEASDN wscript.echo "Attribute Name & Value - " & strAttribute & ": " & strAttValue wscript.echo "Attribute set!!" wscript.echo "" strEASDN = "" rsEAS.MoveNext wend '=====================================================' Closing & Clearing Connections '===================================================== rsEAS.Close Set rsEAS = Nothing rsOrgDN.close Set rsOrgDN = Nothing cnADQuery.Close Set cnADQuery = Nothing '=====================================================' Help Listing '===================================================== Sub DisplayHelpMessage() wscript.echo "Description: This script will enable Windows Integrated Authentication and Basic Authentication" wscript.echo " on the /Microsoft-Server-Activesync virtual directory on Exchange 2003 servers" wscript.echo " within in a defined administrative group." wscript.echo "" wscript.echo "Usage: legacyEAS.vbs -a:<AdministrativeGroupName> [-d:<DomainController>]" wscript.echo "" wscript.echo "Required Arguments:" wscript.echo "" wscript.echo "-a:<AdministrativeGroupName>" wscript.echo "Specify legacy Exchange Administrative Group Name" wscript.echo "Ex: NorthAmerica" wscript.echo "" wscript.echo "Optional Arguments:" wscript.echo "" wscript.echo "-d:<DomainController>" wscript.echo "Specify the domain controller to search" wscript.echo "Ex: W2K3-DC-01" wscript.echo "" wscript.echo "-remove" wscript.echo "Removes the specified attribute" wscript.echo "" wscript.echo "Example: legacyEAS.vbs -d:W2K3-DC-01 -a:NorthAmerica" End Sub
Debuginstall.vbs
Procedure
Use Notepad to create a Visual Basic script to modify the registry for debugging applications
-
Open Notepad or another text editor.
-
Copy the following code into a file and save the file with a descriptive name and the .bat extension. We recommend naming the file debuginstall.vbs.
Copy Code #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!" #"!!!!!!! THIS IS NOT A MICROSOFT SUPPORTED SCRIPT. !!!!!!!!" #"!!!!!!! TEST IN A LAB FOR DESIRED OUTCOME !!!!!!!!" #"!!!!!!! !!!!!!!!!!" #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!" #" " '======================================='debuginstall.vbs ' 'Copyright (c) 2005, Microsoft Corporation. All Rights Reserved. ' 'THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY 'KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE 'IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 'PARTICULAR PURPOSE. ' 'Description: This script will modify the registry for debugging applications. ' 'Written by: Ross Smith IV (Microsoft) ' 'Version: 1.0 'Last Updated: 2/10/2005 '======================================= '====================================================='Define Variables & Constants '===================================================== Option Explicit Dim objRegistry, oArg, i, strEnvKeyPath, strEnvPathName, strEnvPathValue, strServerName, strEnvSymbolName, strEnvSymbolValue Const HKEY_LOCAL_MACHINE = &H80000002 '====================================================='Determine if CSCRIPT must be used '===================================================== if InStr(1,wscript.fullname,"cscript.exe",1) = 0 then wscript.echo "This script should be run using 'cscript.exe <scriptfile>'. Terminating script." wscript.quit end if '====================================================='Clear variables '===================================================== strEnvPathValue = "" strServerName = "." '=====================================================' Parse command-line arguments '===================================================== Set oArg = wscript.arguments For i = 0 to oArg.Count - 1 'Help Arguments If LCase(Left(oArg.Item(i),2)) = "/h" then DisplayHelpMessage wscript.quit end if If LCase(Left(oArg.Item(i),2)) = "/?" then DisplayHelpMessage wscript.quit end if If LCase(Left(oArg.Item(i),5)) = "/help" then DisplayHelpMessage wscript.quit end if 'Get Computer Name for Remote Registry Access If LCase(Left(oArg.Item(i),3)) = "-s:" then strServerName = Mid(oArg.Item(i),4) 'wscript.echo strServerName end if Next '=====================================================' Open Registry '===================================================== Set objRegistry = GetObject("winmgmts:{impersonationLevel=impersonate}!\\" & strServerName & "\root\default:StdRegProv") if Err.Number <> 0 then wscript.echo "ERROR: Unable to connect to remote registry on the local system (" & Err.Number & ", " & Err.Description & "). Registry not updated." wscript.quit end if '=====================================================' Define Registry Variables & Edit the Registry '===================================================== strEnvKeyPath = "System\CurrentControlSet\Control\Session Manager\Environment" strEnvPathName = "Path" strEnvSymbolName = "_NT_SYMBOL_PATH" strEnvSymbolValue = "%SystemRoot%\Symbols" 'wscript.echo strEnvPath 'Get the Path statement objRegistry.GetExpandedStringValue HKEY_LOCAL_MACHINE, strEnvKeyPath, strEnvPathName, strEnvPathValue 'wscript.echo "Before " & strEnvPathValue 'Set Path strEnvPathValue = StrEnvPathValue & ";C:\Tools\Exchange" & ";C:\Tools\Debugging" 'wscript.echo "After " & strEnvPathValue 'Write new registry values objRegistry.SetExpandedStringValue HKEY_LOCAL_MACHINE, strEnvKeyPath, strEnvPathName, strEnvPathValue objRegistry.SetStringValue HKEY_LOCAL_MACHINE, strEnvKeyPath, strEnvSymbolName, strEnvSymbolValue If Err.Number = 0 Then wscript.echo "Registry Updated!" Else WScript.Echo "Registry was not updated!" & " Error = " & Err.Number End If '=====================================================' Closing & Clearing Connections '===================================================== Set objRegistry = Nothing '=====================================================' Help Listing '===================================================== Sub DisplayHelpMessage() wscript.echo "Description: This script will set several registry settings needed" wscript.echo " for debugging applications." wscript.echo "" wscript.echo "Usage: debuginstall.vbs [-s:<ServerName>] [/?] [/h] [/help]" wscript.echo "" wscript.echo "Optional Arguments" wscript.echo "-s:<ServerName>" wscript.echo "Specify the Server to modify" wscript.echo "Ex: E2K-PF-01" wscript.echo "" End Sub
For More Information
For more information about documenting and automating your Exchange server build process, see Server Installation and Automation Guides.