##################################################################################
#
#
#  Script name: Add-SharePointAnnouncement.ps1
#
#  Author:      	niklas.goude@zipper.se
#  Homepage:    	www.powershell.nu
#  Company:		www.zipper.se
#
##################################################################################

param([string]$identity, [string]$List, [string]$Title, [string]$Body, [DateTime]$Expires, [switch]$help)

function GetHelp() {


$HelpText = @"

DESCRIPTION:
NAME: Add-SharePointAnnouncement

Add a New Announcement to SharePoint 2010

PARAMETERS: 
-url		Url to SharePoint Site Collection
-List		Name of List
-Title		Announcement Title
-Body		Announcement Body
-Expires	Expiration Date

SYNTAX:

Add-SharePointAnnouncement -url http://sharepoint -List Announcements -Title "Hello Spock" -Body "<h2>Star Trek</h2><p />on tv @9pm" -Expires 02/02/2010

Opens The SiteCollection.

Add-SharePointAnnouncement -help

Displays the help topic for the script

"@
$HelpText

}
function Add-SharePointAnnouncement ([string]$url, [string]$List, [string]$Title, [string]$Body, [DateTime]$Expires) {

	$siteScope = Start-SPAssignment

	$Announcement = (Get-SPWeb -identity $identity).Lists[$List]

	$NewItem = $Announcement.Items.Add()
	$NewItem["Title"] = $Title
	$NewItem["Body"] = $Body
	$NewItem["Expires"] = $Expires
	$NewItem.Update()

	Stop-SPAssignment $siteScope
}

if($help) { GetHelp }

if($identity -AND $List -AND $Title -AND $Body -AND $Expires) {
	Add-SharePointAnnouncement -identity $identity -List $List -Title $Title -Body $Body -Expires $Expires
}