ZimbraPowerShell (ZPS)

READ THIS ENTIRE FILE

===============================================================================

  Overview
  ----------

  ZPS consists of PowerShell scripts that can send SOAP requests to ZCS, plus 
  additional utilites.

===============================================================================

  Getting Started
  ---------------

* Download PowerShell 1.0
  http://www.microsoft.com/technet/scriptcenter/topics/msh/download.mspx

* Set your execution policy
  PS> get-help set-executionPolicy

* Generate the master script file
  PS> .\Build-ZimbraPowerShell.ps1

* Source the master script file (adds all the functions to your shell)
  PS> . .\ZimbraPowerShell.ps1

* Create a user session
  PS> Create-Session http://localhost:7070 user1@example.com test123
  
  The session is stored in $zimbraSession.  The session stores the host, user
  authToken, request and response.  The SOAP scripts require the session to be
  valid or you may experience unexpected behavior.

* Create an admin session
  PS> Create-Sesion https://localhost:7071 admin@example.com test123 -IsAdmin $true

  The session is stored in $zimbraSession.  The session stores the host, user
  authToken, request and response.  The SOAP scripts require the session to be
  valid or you may experience unexpected behavior.
  
===============================================================================

  Tips
  ----

*  View a list of all the commands
   PS> Get-ZimbraHelp

*  Get detailed help on each command by specifying -? or -help

*  View the debug output of the scripts by setting $DebugPreference
   PS> $DebugPreference="Continue"

   To turn off debug output,
   PS> $DebugPreference="SilentlyContinue"
   
*  Pretty print the previous SOAP request
   PS> $zimbraSession.Request | format-xml

*  Pretty print the previous SOAP response
   PS> $zimbraSession.Response | format-xml

*  Inspect the sample scripts

*  When using SSL and your server has self-signed certificates, you 
   must import the certificate.  To import the certificate, open the 
   target url using IE and click the certificate.  Follow the steps 
   in the wizard.

===============================================================================
