伺服器組建 DVD PowerShell 指令碼範例

  • 發行項

 

適用版本： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上次修改主題的時間： 2008-07-23

本主題提供的範例 Microsoft Windows PowerShell 指令碼，可作為建立指令碼的起點，製作組建 DVD 以改善伺服器組建處理程序需要該指令碼。您可以修改下列程序，為組織建立必要的 PowerShell 指令碼。

下列範例指令碼必須如指令碼備註所述進行修改，才能在您的特定環境中運作。此指令碼可協助您自動化許多在環境中部署 Exchange 伺服器所需的步驟。

PowerShell 支援指令碼

important重要事項：
這些指令碼是用來說明如何實作自動化步驟的範例。您必須加以修改，以讓指令碼適合您的環境。您必須在實驗室環境中進行各項測試，之後才能嘗試在生產環境中加以運用。

開始之前

若要執行下列程序，您使用的帳戶必須是本機 Administrators 群組的成員。

如需管理 Exchange 2007 所需之權限、委派角色及權利的相關資訊，請參閱權限考量。

Set-registry.ps1

程序

使用記事本建立 PowerShell 指令碼，實作 Exchange 2007 伺服器的必要登錄修改

  1. 開啟記事本或其他文字編輯器。

  2. 將下列程式碼複製到檔案中，並將此檔案以描述性名稱與 .ps1 副檔名加以儲存。建議您將檔案命名為 set-registry.ps1。

    #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#"!!!!!!!  THIS IS NOT A MICROSOFT SUPPORTED SCRIPT.  !!!!!!!!"
#"!!!!!!!      TEST IN A LAB FOR DESIRED OUTCOME      !!!!!!!!"
#"!!!!!!!                          !!!!!!!!!!"
#"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#" "
#=======================================
#Set-Registry.ps1
#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: Script to configure HKEY_LOCAL_MACHINE registry settings on local or remote servers. 
#Based on Original Work By: Christian Schindler (NTx BOCG)
#This Script Written by: Ross Smith IV (Microsoft)
#Version: 1.0
#Last Updated: 4/16/2007
#=======================================

# To get help, just add the \"-help\" paramter

#=======================================
# Parameter definition
#=======================================
Param(
[string] $Server,
[string] $RegKey,
[string] $RegValue,
[string] $RegData,
[string] $RegType
)

#=======================================
# Function that validates the script parameters
#=======================================
function ValidateParams
{
$validInputs = $true
$errorString =  ""

if ($Server -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -Server parameter is required. Please pass in the name of a valid Server." + "`n"
}

if ($RegKey -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -RegKey parameter is required. Please pass in the name of a registry key." + "`n"
}

if ($RegValue -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -RegValue parameter is required. Please pass in the name of a registry value." + "`n"
}

if ($RegData -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -RegData parameter is required. Please pass in the registry value's data." + "`n"
}

    $RegType = $RegType.ToUpper()
switch ($RegType)
{
STRING {return $validInputs}
        EXPANDSTRING {return $validInputs}
        MULTISTRING {return $validInputs}
        DWORD {return $validInputs}
QWORD {return $validInputs}
        BINARY {return $validInputs}
        default 
{
if ($RegType -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -RegType parameter is required. Please pass in the registry value's type." + "`n"
}
            else
            { 
                $validInputs = $false
                $errorString += "`n`nIncorrect Parameter: The value specified for the -RegType parameter is incorrect. Please pass in the registry value's type." + "`n"
            }
}
}

if (!$validInputs)
{
Write-error "$errorString"
}

return $validInputs
}

#=======================================
# Function that returns true if the incoming argument is a help request
#=======================================
function IsHelpRequest
{
param($argument)
return ($argument -eq "-?" -or $argument -eq "-help");
}

#=======================================
# Function that displays the help related to this script following
# the same format provided by get-help or <cmdletcall> -?
#=======================================
function Usage
{
@"
NAME: Set-Registry.ps1

SYNOPSIS:
Configures local or remote server's HKEY_LOCAL_MACHINE registry settings.

SYNTAX:
Set-Registry.ps1
`t[-Server <CASServerName>]
`t[-RegKey <KeyPath>]
`t[-RegValue <ValueName>]
`t[-RegData <ValueData>]
`t[-RegType <ValueType>]

PARAMETERS:
-Server (required)
The server to operate against.

-RegKey (required)
Specifies the registry key.

-RegValue (required)
Specifies the registry value within the key.

-RegData (required)
Specifies the registry value's data.

-RegType (required)
Specifies the registry value's data type.

-------------------------- EXAMPLE 1 --------------------------

.\Set-Registry.ps1 -Server CAS1 -RegKey "SYSTEM\CurrentControlSet\Services\MSExchange OWA" -RegValue PrivateTimeout -RegData 24 -RegType dword

"@
}

#=======================================
# Check for Usage Statement Request
#=======================================
$args | foreach { if (IsHelpRequest $_) { Usage; exit; } }

#=======================================
# Validate the parameters and Execute the functions
#=======================================
$ifValidParams = ValidateParams;

if (!$ifValidParams) { exit; }

#=======================================
# Determine if Server is Local Machine
#=======================================
$server = $server.ToUpper()
$LocalServerName = hostname
if ($LocalServerName -eq $server) {$IsLocal = "True"} else {$IsLocal = "False"}

#=======================================
# Configure Registry Function
#=======================================
function ConfigureRegistry
{
Write-Host "Configuring Registry Settings..."
if ($IsLocal -eq "True")
{ set-ItemProperty "HKLM:$RegKey" -name "$RegValue" -value "$RegData" -type $RegType }
else
{
$rootkey=[Microsoft.Win32.RegistryKey]::OpenRemoteBaseKey("LOCALMACHINE",$server).OpenSubKey("$RegKey", [Microsoft.Win32.RegistryKeyPermissionCheck]::ReadWriteSubTree)
$SetRegValue=$rootkey
$SetRegValue.SetValue("$RegValue", "$RegData", [Microsoft.Win32.RegistryValueKind]::$RegType)
$rootkey.Flush()
$rootkey.Close()
}
}

#=======================================
# Assign values to Variables
#=======================================

#=======================================
# Execute functions
#=======================================

ConfigureRegistry;

ConfigureAutoDiscover.ps1

程序

使用記事本建立 PowerShell 指令碼，在已安裝 Client Access server role 的 Exchange 2007 伺服器上設定自動探索

  1. 開啟記事本或其他文字編輯器。

  2. 將下列程式碼複製到檔案中，並將此檔案以描述性名稱與 .ps1 副檔名加以儲存。建議您將檔案命名為 configureautodiscover.ps1。

    #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#"!!!!!!!  THIS IS NOT A MICROSOFT SUPPORTED SCRIPT.  !!!!!!!!"
#"!!!!!!!      TEST IN A LAB FOR DESIRED OUTCOME      !!!!!!!!"
#"!!!!!!!                          !!!!!!!!!!"
#"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#" "
#==========================================================================
#ConfigureAutoDiscover.ps1
#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: Script to configure AutoDiscover on a CAS server. 
#Based on Original Work By: Christian Schindler (NTx BOCG)
#This Script Written By: Ross Smith IV (Microsoft)
#Version: 1.4
#Last Updated: 2/26/2007
#==========================================================================

# To get help, just add the \"-help\" paramter

#=======================================
# Parameter definition
#=======================================
Param(
[string] $InternalName,
[string] $ExternalName,
[string] $Server,
[string] $SiteAffinity,
[switch] $OutlookAnywhereAuthNTLM,
[switch] $InternetUsage,
[switch] $SiteAffinityEnabled
)

#==============================================
# Function that validates the script parameters
#==============================================
function ValidateParams
{
$validInputs = $true
$errorString =  ""

if ($Server -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -Server parameter is required. Please pass in the name of a valid CAS Server." + "`n"
}

if ($InternetUsage)
{
if ($ExternalName -eq "")
{
$validInputs = $false
$errorString += "`nMissing Parameter: The -ExternalName parameter is required. Please pass in the desired FQDN."
}
}

if ($InternalName -eq "")
{
$validInputs = $false
$errorString += "`nMissing Parameter: The -InternalName parameter is required. Please pass in the desired FQDN."
}

if ($SiteAffinity -ne "")
{ _In
$SiteAffinityEnabled = $true
}

if (!$validInputs)
{
Write-error "$errorString"
}

return $validInputs
}

#==========================================================================
# Function that returns true if the incoming argument is a help request
#==========================================================================
function IsHelpRequest
{
param($argument)
return ($argument -eq "-?" -or $argument -eq "-help");
}

#===================================================================
# Function that displays the help related to this script following
# the same format provided by get-help or <cmdletcall> -?
#===================================================================
function Usage
{
@"
NAME: ConfigureAutoDiscover.ps1

SYNOPSIS:
Configures AutoDiscover and the Exchange Services on an Exchange 2007
CAS Server for usage by Internet and Internal clients.
Virtual Directories covered are: Exchange ActiveSync, RPC, OAB, UM, EWS

SYNTAX:
ConfigureAutoDiscover.ps1
`t[-Server <CASServerName>]
`t[-InternalName <InternalFQDN>]
`t[-SiteAffinity <Active Directory Site>]
`t[-InternetUsage]
`t[-ExternalName <ExternalFQDN>]
`t[-OutlookAnywhereAuthNTLM]

PARAMETERS:
-Server (required)
The server to operate against. Must be an Exchange 2007 CAS server.

-InternalName (required)
The internal FQDN under which the services will be accessible.

-SiteAffinity (optional)
If set, the script will configure site affinity for the Autodiscover service on the CAS server.

-InternetUsage (optional)
If set, the script will also configure the OAB, RPC, EAS, and EWS virtual directories for AutoDiscover Internet usage.

-ExternalName (required with -InternetUsage)
The external FQDN under which the services will be accessible.

-OutlookAnywhereAuthNTLM (optional)
If set, the script will configure the authentication mechanism for Outlook Anywhere Clients to use NTLM instead of Basic.

-------------------------- EXAMPLE 1 --------------------------

.\ConfigureAutoDiscover.ps1 -Server CAS1 -InternalName CAS01.ad.contoso.com

-------------------------- EXAMPLE 2 --------------------------

.\ConfigureAutoDiscover.ps1 -Server CAS1 -InternalName CAS01.ad.contoso.com -ExternalName mail.contoso.com -InternetUsage

-------------------------- EXAMPLE 3 --------------------------

.\ConfigureAutoDiscover.ps1 -Server CAS1 -InternalName CAS01.ad.contoso.com -ExternalName mail.contoso.com -InternetUsage -SiteAffinity Redmond-AD-Site -OutlookAnywhereAuthNTLM

"@
}

#=======================================
# Check for Usage Statement Request
#=======================================
$args | foreach { if (IsHelpRequest $_) { Usage; exit; } }

#=====================================================
# Validate the parameters and Execute the functions
#=====================================================
$ifValidParams = ValidateParams;

if (!$ifValidParams) { exit; }

#===================================================
# Configure Internal AutoDiscover Settings Function
#===================================================
function ConfigureInternalAutoDiscover
{
Write-Host "Configuring AutoDiscover Internal Settings..."
if ($SiteAffinityEnabled = $true)
{Set-ClientAccessServer -Identity $server -AutodiscoverServiceInternalURI https://$InternalName/$ad -AutodiscoverSiteScope $SiteAffinity}
else
{Set-ClientAccessServer -Identity $server -AutoDiscoverServiceInternalUri https://$InternalName/$ad}
}

#===================================================
# Configure Internet AutoDiscover Settings Function
#===================================================
function ConfigureInternetUsage
{
Write-Host "Configuring AutoDiscover related Internet Settings..."

if ($OutlookAnywhereAuthNTLM)
{Enable-OutlookAnywhere -Server $server -ExternalHostname $ExternalName -DefaultAuthenticationMethod "NTLM" -SSLOffloading:$False}
else
{Enable-OutlookAnywhere -Server $server -ExternalHostname $ExternalName -DefaultAuthenticationMethod "Basic" -SSLOffloading:$False}

Set-OABVirtualDirectory -identity $oabvdir -externalurl https://$ExternalName/$OAB
Set-UMVirtualDirectory -identity $umvdir -externalurl https://$ExternalName/$um  
Set-WebServicesVirtualDirectory -identity $ewsvdir -externalurl https://$ExternalName/$ews 
Set-ActiveSyncVirtualDirectory -Identity $easvdir -ExternalURL "https://$ExternalName"
}

#=======================================
# Assign values to Variables
#=======================================
$easvdir = "$server\Microsoft-Server-ActiveSync (Default Web Site)"
$ewsvdir = "$Server\EWS (Default Web Site)"
$oabvdir = "$Server\OAB (Default Web Site)"
$umvdir = "$Server\UnifiedMessaging (Default Web Site)"
$eas = "Microsoft-Server-ActiveSync"
$ad = "autodiscover/autodiscover.xml"
$oab = "oab"
$owa = "owa"
$um = "UnifiedMessaging/Service.asmx"
$ews = "ews/exchange.asmx"

#=======================================
# Execute functions
#=======================================

if ($InternetUsage) 
{ConfigureInternalAutoDiscover; ConfigureInternetUsage;}
else
{ConfigureInternalAutoDiscover;}

ConfigureOAB.ps1

程序

使用記事本建立 PowerShell 指令碼，在已安裝 Client Access server role 的 Exchange 2007 伺服器上設定離線通訊錄 Web 發佈

  1. 開啟記事本或其他文字編輯器。

  2. 將下列程式碼複製到檔案中，並將此檔案以描述性名稱與 .ps1 副檔名加以儲存。建議您將檔案命名為 configureoab.ps1。

    #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#"!!!!!!!  THIS IS NOT A MICROSOFT SUPPORTED SCRIPT.  !!!!!!!!"
#"!!!!!!!      TEST IN A LAB FOR DESIRED OUTCOME      !!!!!!!!"
#"!!!!!!!                          !!!!!!!!!!"
#"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#" "
#=================================================================================
#ConfigureOAB.ps1
#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: Configures Offline Address Book Web Distribution on an Exchange 2007
# CAS Server for usage by Internet and Internal clients. 
#Based on Original Work By: Christian Schindler (NTx BOCG)
#This Script Written By: Ross Smith IV (Microsoft)
#Version: 1.6
#Last Updated: 12/4/2007
#=================================================================================

# To get help, just add the \"-help\" paramter

#=======================================
# Parameter definition
#=======================================
Param(
[string] $ExternalName,
[string] $Server,
[string] $OABName,
[switch] $RequireOABSSL
)

#==============================================
# Function that validates the script parameters
#==============================================
function ValidateParams
{
$validInputs = $true
$errorString =  ""

if ($Server -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -Server parameter is required. Please pass in the name of a valid CAS Server." + "`n"
}

if ($OABName -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -OABName parameter is required. Please pass in the name of a valid offline address book name." + "`n"
}


if ($ExternalName -eq "")
{
$validInputs = $false
$errorString += "`nMissing Parameter: The -ExternalName parameter is required. Please pass in the desired FQDN."
}

if (!$validInputs)
{
Write-error "$errorString"
}

return $validInputs
}

#==========================================================================
# Function that returns true if the incoming argument is a help request
#==========================================================================
function IsHelpRequest
{
param($argument)
return ($argument -eq "-?" -or $argument -eq "-help");
}

#===================================================================
# Function that displays the help related to this script following
# the same format provided by get-help or <cmdletcall> -?
#===================================================================
function Usage
{
@"
NAME: ConfigureOAB.ps1

SYNOPSIS:
Configures Offline Adress Book Web Distribution on an Exchange 2007
CAS Server for usage by Internet and Internal clients.

SYNTAX:
ConfigureOAB.ps1
`t[-Server <CASServerName>]
`t[-ExternalName <ExternalFQDN>]
`t[-OABName <OABName>]
`t[-RequireOABSSL]

PARAMETERS:
-Server (required)
The server to operate against. Must be an Exchange 2007 CAS server.

-ExternalName (required)
The external FQDN under which the services will be accessible.

-OABName (required)
The name of the offline address book that will be configured for web distribution.

-RequireOABSSL (optional)
If set, the script will require SSL for clients to access the OAB virtual directory.  
By default clients do not have to use SSL because BITS cannot be used 
when the CAS certificate is self-signed.

-------------------------- EXAMPLE 1 --------------------------

.\ConfigureOAB.ps1 -Server CAS1 -ExternalName mail.contoso.com -OABName "Default Offline Address Book"

-------------------------- EXAMPLE 2 --------------------------

.\ConfigureOAB.ps1 -Server CAS1 -ExternalName mail.contoso.com -OABName "Default Offline Address Book" -RequireOABSSL

"@
}

#=======================================
# Check for Usage Statement Request
#=======================================
$args | foreach { if (IsHelpRequest $_) { Usage; exit; } }

#=====================================================
# Validate the parameters and Execute the functions
#=====================================================
$ifValidParams = ValidateParams;

if (!$ifValidParams) { exit; }

#==============================================
# Determine if Server is Local Machine Function
#==============================================
$server = $server.ToUpper()
$LocalServerName = hostname
if ($LocalServerName -eq $server) {$IsLocal = "True"} else {$IsLocal = "False"}

#=======================================
# Enable OAB Web Distribution Function
#=======================================
function ConfigureOABDistribution
{
# Get Exchange Organization Distinguished Name
$rootdom = "LDAP://rootDSE"
$RootDomain = [System.DirectoryServices.DirectoryEntry] $rootdom
$ConfigurationNC = $RootDomain.Get("configurationNamingContext")

$OrgContainer = "cn=Microsoft Exchange,cn=services,$ConfigurationNC"

$OrgSearch = New-Object DirectoryServices.DirectorySearcher
    $OrgSearch.SearchRoot = [System.DirectoryServices.DirectoryEntry] "LDAP://$orgContainer" 
    $OrgSearch.Filter = '(objectCategory=msExchOrganizationContainer)'
    $OrgResult = $OrgSearch.FindOne()

    if ($OrgResult -eq $NULL)
    {
Write-Host "Could not find a valid Exchange Organization!"
exit;
    }
    else 
    {
$OrgDN = $OrgResult.Properties.distinguishedname
}

# Build OAB Vdir DN
$OABVDirDN = "CN=OAB (Default Web Site),CN=HTTP,CN=Protocols,CN=$server,CN=Servers,CN=Exchange Administrative Group (FYDIBOHF23SPDLT),CN=Administrative Groups,$OrgDN"

# get existing OAB v-dirs that may be set
$GetOABVDirs = get-OfflineAddressBook $oabname
$GetOABVDirs.VirtualDirectories += $OABVDirDN

#Set new OAB Vdir
Write-Host "Configuring OAB for Web Distribution..."
Set-oabvirtualdirectory -identity $oabvdir -ExternalURL https://$ExternalName/$OAB
Set-OfflineAddressBook $oabname -VirtualDirectories $GetOABVDirs.VirtualDirectories
}

#=======================================
# Enable OAB V-Dir SSL
#=======================================
function ConfigureOABSSL
{
Write-Host "Configuring OAB Virtual Directory to Require SSL..."
Set-OABVirtualDirectory -identity $oabvdir -RequireSSL
}

#=======================================
# Reset IIS on the server
#=======================================
function ResetIIS
{
if ($isLocal -eq "True")
{Write-Host "Restarting IIS Services..."
iisreset /noforce}
else
{Write-Host "Please restart the IIS services on $server by executing the command iisreset /noforce."}
}

#=======================================
# Assign values to Variables
#=======================================
$oabvdir = "$Server\OAB (Default Web Site)"
$oab = "oab"

#=======================================
# Execute functions
#=======================================

if ($EnableOABSSL) 
{ConfigureOABDistribution; ConfigureOABSSL; ResetIIS;}
else
{ConfigureOABDistribution; ResetIIS;}

ConfigureOLAnywhere.ps1

程序

使用記事本建立 PowerShell 指令碼，在已安裝 Client Access server role 的 Exchange 2007 伺服器上設定 Outlook 無所不在

  1. 開啟記事本或其他文字編輯器。

  2. 將下列程式碼複製到檔案中，並將此檔案以描述性名稱與 .ps1 副檔名加以儲存。建議您將檔案命名為 configureolanywhere.ps1。

    #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#"!!!!!!!  THIS IS NOT A MICROSOFT SUPPORTED SCRIPT.  !!!!!!!!"
#"!!!!!!!      TEST IN A LAB FOR DESIRED OUTCOME      !!!!!!!!"
#"!!!!!!!                          !!!!!!!!!!"
#"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#" "
#==========================================================================
#ConfigureOLAnywhere.ps1
#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: Configures Outlook Anywhere on an Exchange 2007
# CAS Server for usage by Internet and Internal clients. 
#Based on Original Work By: Christian Schindler (NTx BOCG)
#This Script Written By: Ross Smith IV (Microsoft)
#Version: 1.5
#Last Updated: 3/5/2008
#==========================================================================

# To get help, just add the \"-help\" paramter

#=======================================
# Parameter definition
#=======================================
Param(
[string] $ExternalName,
[string] $Server,
[switch] $OutlookAnywhereAuthNTLM
)

#==============================================
# Function that validates the script parameters
#==============================================
function ValidateParams
{
$validInputs = $true
$errorString =  ""

if ($Server -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -Server parameter is required. Please pass in the name of a valid CAS Server." + "`n"
}

if ($ExternalName -eq "")
{
$validInputs = $false
$errorString += "`nMissing Parameter: The -ExternalName parameter is required. Please pass in the desired FQDN."
}

if (!$validInputs)
{
Write-error "$errorString"
}

return $validInputs
}

#==========================================================================
# Function that returns true if the incoming argument is a help request
#==========================================================================
function IsHelpRequest
{
param($argument)
return ($argument -eq "-?" -or $argument -eq "-help");
}

#===================================================================
# Function that displays the help related to this script following
# the same format provided by get-help or <cmdletcall> -?
#===================================================================
function Usage
{
@"
NAME: ConfigureOLAnywhere.ps1

SYNOPSIS:
Configures Offline Adress Book Web Distribution on an Exchange 2007
CAS Server for usage by Internet and Internal clients.

SYNTAX:
ConfigureOLAnywhere.ps1
`t[-Server <CASServerName>]
`t[-ExternalName <ExternalFQDN>]
`t[-OutlookAnywhereAuthNTLM]

PARAMETERS:
-Server (required)
The server to operate against. Must be an Exchange 2007 CAS server.

-ExternalName (required)
The external FQDN under which the services will be accessible.

-OutlookAnywhereAuthNTLM (optional)
If set, the script will configure the authentication mechanism for Outlook Anywhere Clients to use NTLM instead of Basic.

-------------------------- EXAMPLE 1 --------------------------

.\ConfigureOLAnywhere.ps1 -Server CAS1 -ExternalName mail.contoso.com 

-------------------------- EXAMPLE 2 --------------------------

.\ConfigureOLAnywhere.ps1 -Server CAS1 -ExternalName mail.contoso.com -OutlookAnywhereAuthNTLM

"@
}

#=======================================
# Check for Usage Statement Request
#=======================================
$args | foreach { if (IsHelpRequest $_) { Usage; exit; } }

#=====================================================
# Validate the parameters and Execute the functions
#=====================================================
$ifValidParams = ValidateParams;

if (!$ifValidParams) { exit; }

#=======================================
# Determine if Server is Local Machine Function
#=======================================
$server = $server.ToUpper()
$LocalServerName = hostname
if ($LocalServerName -eq $server) {$IsLocal = "True"} else {$IsLocal = "False"}

#=======================================
# Configure Outlook Anywhere Function
#=======================================
function ConfigureOLAnywhere
{
$OAenabled = Get-OutlookAnywhere -Server $Server

if ($OAenabled -eq $Null)
{
Write-Host "Enabling Outlook Anywhere..."; 
if ($OutlookAnywhereAuthNTLM)
{Enable-OutlookAnywhere -Server $server -ExternalHostname $ExternalName -DefaultAuthenticationMethod "NTLM" -SSLOffloading:$False}
else
{Enable-OutlookAnywhere -Server $server -ExternalHostname $ExternalName -DefaultAuthenticationMethod "Basic" -SSLOffloading:$False}
}
else
{Write-Host "Outlook Anywhere is already enabled"}
}

#=======================================
# Reset IIS on the server
#=======================================
function ResetIIS
{
if ($isLocal -eq "True")
{Write-Host "Restarting IIS Services..."
iisreset /noforce}
else
{Write-Host "Please restart the IIS services on $server by executing the command iisreset /noforce."}
}

#=======================================
# Assign values to Variables
#=======================================

#=======================================
# Execute functions
#=======================================

ConfigureOLAnywhere; ResetIIS;

ConfigureOWA.ps1

程序

使用記事本建立 PowerShell 指令碼，在已安裝 Client Access server role 的 Exchange 2007 伺服器上設定 Outlook Web Access

  1. 開啟記事本或其他文字編輯器。

  2. 將下列程式碼複製到檔案中，並將此檔案以描述性名稱與 .ps1 副檔名加以儲存。建議您將檔案命名為 configureowa.ps1。

    #"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#"!!!!!!!  THIS IS NOT A MICROSOFT SUPPORTED SCRIPT.  !!!!!!!!"
#"!!!!!!!      TEST IN A LAB FOR DESIRED OUTCOME      !!!!!!!!"
#"!!!!!!!                          !!!!!!!!!!"
#"!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!"
#" "
#=======================================
#ConfigureOWA.ps1
#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: Script to configure OWA settings on a CAS server. 
#Based on Original Work By: Christian Schindler (NTx BOCG)
#This Script Written by: Ross Smith IV (Microsoft)
#Version: 1.5
#Last Updated: 3/16/2007
#=======================================

# To get help, just add the \"-help\" paramter

#=======================================
# Parameter definition
#=======================================
Param(
[string] $ExternalName,
[string] $Server,
[string] $PublicTO,
[string] $PrivateTO,
[switch] $EnableGZipHigh,
[switch] $EnableFBA,
[switch] $EnableIntAuth,
[switch] $ForcePublicWebReady,
[switch] $DisablePublicWSSAccess,
[switch] $DisablePrivateWSSAccess,
[switch] $DisablePublicUNCAccess,
[switch] $DisablePrivateUNCAccess,
[switch] $EnableRedirection,
[switch] $SetLegacyVDirs
)

#=======================================
# Function that validates the script parameters
#=======================================
function ValidateParams
{
$validInputs = $true
$errorString =  ""

if ($Server -eq "")
{
$validInputs = $false
$errorString += "`n`nMissing Parameter: The -Server parameter is required. Please pass in the name of a valid CAS Server." + "`n"
}

if ($EnableRedirection)
{
if ($ExternalName -eq "")
{
$validInputs = $false
$errorString += "`nMissing Parameter: The -ExternalName parameter is required. Please pass in the desired FQDN."
}
}

if (!$validInputs)
{
Write-error "$errorString"
}

return $validInputs
}

#=======================================
# Function that returns true if the incoming argument is a help request
#=======================================
function IsHelpRequest
{
param($argument)
return ($argument -eq "-?" -or $argument -eq "-help");
}

#=======================================
# Function that displays the help related to this script following
# the same format provided by get-help or <cmdletcall> -?
#=======================================
function Usage
{
@"
NAME: ConfigureOWA.ps1

SYNOPSIS:
Configures Outlook Web Access settings on an Exchange 2007
CAS Server.  IIS services will be restarted after configuration.

SYNTAX:
ConfigureOWA.ps1
`t[-Server <CASServerName>]
`t[-EnableFBA]
`t[-EnableIntAuth]
`t[-EnableRedirection]
`t[-ExternalName <FQDN>]
`t[-PublicTO <Timeout Value>]
`t[-PrivateTO <Timeout Value>]
`t[-EnableGZipHigh]
`t[-ForcePublicWebReady]
`t[-DisablePublicWSSAccess]
`t[-DisablePublicUNCAccess]
`t[-DisablePrivateWSSAccess]
`t[-DisablePrivateUNCAccess]
`t[-SetLegacyVDirs]

PARAMETERS:
-Server (required)
The server to operate against. Must be an Exchange 2007 CAS server.

-EnableFBA (optional)
Configures the server use Forms-Based Authentication (enabled by default during CAS installation).

-EnableIntAuth (optional)
Configures the server use Windows Integrated Authentication.

-EnableRedirection (optional)
Configures the server to redirect the user to the appropriate CAS server.

-ExternalName (Required with EnableRedirection)
The external FQDN under which the services will be accessible.

-PublicTO (Optional)
The public timeout value in minutes for Forms-Based Authentication.

-PrivateTO (Optional)
The public timeout value in minutes for Forms-Based Authentication

-EnableGZipHigh (Optional)
OWA is configured to use GZip Low GZip compression. This option will enable High compresssion.

-ForcePublicWebReady (Optional)
This parameter forces certain attachments to be viewed via a web interface when clients connect via the Public Computer FBA option.

-DisablePublicWSSAccess (Optional)
This parameter will disable SharePoint Document Library access via the Public Computer FBA access option.

-DisablePublicUNCAccess (Optional)
This parameter will disable File Share access via the Public Computer FBA access option.

-DisablePrivateWSSAccess (Optional)
This parameter will disable SharePoint Document Library access via the Private Computer FBA access option.

-DisablePrivateUNCAccess (Optional)
This parameter will disable File Share access via the Private FBA access option.

-SetLegacyVDirs (Optional)
This parameter sets the same options on /exchange, /public, and /exchweb that are used on /owa.

-------------------------- EXAMPLE 1 --------------------------

.\ConfigureOWA.ps1 -Server CAS1 -EnableFBA -EnableGZipHigh -ForcePublicWebReady -DisablePublicWSSAccess -DisablePublicUNCAccess

-------------------------- EXAMPLE 2 --------------------------

.\ConfigureOWA.ps1 -Server CAS1 -EnableIntAuth -SetLegacyVDirs -DisablePrivateWSSAccess -DisablePrivateUNCAccess -PrivateTO 360 -PublicTO 60

-------------------------- EXAMPLE 3 --------------------------

.\ConfigureOWA.ps1 -Server CAS1 -EnableRedirection -ExternalName mail.contoso.com

"@
}

#=======================================
# Check for Usage Statement Request
#=======================================
$args | foreach { if (IsHelpRequest $_) { Usage; exit; } }

#=======================================
# Validate the parameters and Execute the functions
#=======================================
$ifValidParams = ValidateParams;

if (!$ifValidParams) { exit; }

#=======================================
# Determine if Server is Local Machine
#=======================================
$server = $server.ToUpper()
$LocalServerName = hostname
if ($LocalServerName -eq $server) {$IsLocal = "True"} else {$IsLocal = "False"}

#=======================================
# Determine if Timeout is enabled
#=======================================
$TimeoutEnabled = "False"
if ($PublicTO -ne $NULL) {$TimeoutEnabled = "True"}
if ($PrivateTO -ne $NULL) {$TimeoutEnabled = "True"}

#=======================================
# Configure OWA V-Dir Function
#=======================================
function ConfigureOWA
{
Write-Host "Configuring Outlook Web Access Settings..."
if ($EnableFBA)
{Set-owavirtualdirectory -identity $owavdir -FormsAuthentication:$true}

if ($EnableIntAuth)
{Set-owavirtualdirectory -identity $owavdir -WindowsAuthentication:$true}

if ($EnableGZipHigh)
{Set-owavirtualdirectory -identity $owavdir -GzipLevel High}

if ($Timeoutenabled -eq "True")
{
if ($IsLocal -eq "True")
{
if ($PrivateTO)
{set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Services\MSExchange OWA" -name PrivateTimeout -value $PrivateTO -type dword}
if ($PublicTO)
{set-ItemProperty "HKLM:\SYSTEM\CurrentControlSet\Services\MSExchange OWA" -name PublicTimeout -value $PublicTO -type dword}
}
else
{
$rootkey=[Microsoft.Win32.RegistryKey]::OpenRemoteBaseKey("LOCALMACHINE",$server).OpenSubKey("SYSTEM\CurrentControlSet\Services\MSExchange OWA", [Microsoft.Win32.RegistryKeyPermissionCheck]::ReadWriteSubTree)
if ($PrivateTO)
{$PrivateTOValue=$rootkey
$PrivateTOValue.SetValue("PrivateTimeout", "$PrivateTO", [Microsoft.Win32.RegistryValueKind]::DWord)}
if ($PublicTO)
{$PublicTOValue=$rootkey
$PublicTOValue.SetValue("PublicTimeout", "$PublicTO", [Microsoft.Win32.RegistryValueKind]::DWord)}
$rootkey.Flush()
$rootkey.Close()
}
}

if ($ForcePublicWebReady)
{Set-owavirtualdirectory -identity $owavdir -ForceWebReadyDocumentViewingFirstOnPublicComputers $true}

if ($DisablePublicWSSAccess)
{Set-owavirtualdirectory -identity $owavdir -WSSAccessOnPublicComputersEnabled $true}

if ($DisablePrivateWSSAccess)
{Set-owavirtualdirectory -identity $owavdir -WSSAccessOnPrivateComputersEnabled $true}

if ($DisablePublicUNCAccess)
{Set-owavirtualdirectory -identity $owavdir -UNCAccessOnPublicComputersEnabled $true}

if ($DisablePrivateUNCAccess)
{Set-owavirtualdirectory -identity $owavdir -UNCAccessOnPrivateComputersEnabled $true}

if ($EnableRedirection)
{Set-OwaVirtualDirectory -identity $owavdir -ExternalURL https://$ExternalName/$owa}
}

#=======================================
# Configure Legacy Virtual Directories Function
#=======================================
function ConfigureLegacyVDirs
{
Write-Host "Configuring Legacy Outlook Web Access Settings..."
if ($EnableFBA)
{Set-owavirtualdirectory -identity $exchangevdir -FormsAuthentication:$true
Set-owavirtualdirectory -identity $exchwebvdir -FormsAuthentication:$true
Set-owavirtualdirectory -identity $Publicvdir -FormsAuthentication:$true}

if ($EnableIntAuth)
{Set-owavirtualdirectory -identity $exchangevdir -WindowsAuthentication:$true
Set-owavirtualdirectory -identity $exchwebvdir -WindowsAuthentication:$true
Set-owavirtualdirectory -identity $Publicvdir -WindowsAuthentication:$true}

if ($EnableGZipHigh)
{Set-owavirtualdirectory -identity $exchangevdir -GzipLevel High
Set-owavirtualdirectory -identity $exchwebvdir -GzipLevel High
Set-owavirtualdirectory -identity $Publicvdir -GzipLevel High}
}

#=======================================
# Reset IIS on the server
#=======================================
function ResetIIS
{
if ($IsLocal -eq "True")
{Write-Host "Restarting IIS Services..."
iisreset /noforce}
else
{Write-Host "Please restart the IIS services on $server by executing the command iisreset /noforce."}
}

#=======================================
# Assign values to Variables
#=======================================
$owavdir = "$server\OWA (Default Web Site)"
$exchwebvdir = "$server\exchweb (Default Web Site)"
$Publicvdir = "$server\public (Default Web Site)"
$exchangevdir = "$server\exchange (Default Web Site)"
$owa = "owa"
$exchange = "exchange"
$Public = "public"
$exchweb = "exchweb"

#=======================================
# Execute functions
#=======================================

if ($SetLegacyVDirs)
{ConfigureOWA; ConfigureLegacyVDirs; ResetIIS;}
else
{ConfigureOWA; ResetIIS;}

相關資訊

如需記載和自動化 Exchange 伺服器組建處理程序的相關資訊，請參閱伺服器安裝和自動化指南。

若要確保您目前閱讀的是最新資訊，並尋找其他的 Exchange Server 2007 說明文件，請造訪 Exchange Server 技術資源中心.