ManageProfanityFilter.ps1.txt 

# Copyright (c) 2008 Microsoft Corporation. All rights reserved.
#
# THIS CODE IS MADE AVAILABLE AS IS, WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK
# OF THE USE OR THE RESULTS FROM THE USE OF THIS CODE REMAINS WITH THE USER.

# NAME:
# ManageProfanityFilter.ps1

# SYNOPSIS:
# Creates a 'Bad Word Filter' by creating a transport rule
# that rejects mail containing profanity.

# SYNTAX:
# ManageProfanityFilter.ps1
# [-Rulename <String>]
# [-WordListFile <Strings>]
# [-RejectionReason <String>]
# [-ExceptForMembersOf <RecipientIdParameter>]
# [-RemoteURL <String>]
# [-LiveCredential <PSCredential>]

# PARAMETERS:
# -Rulename (required)
# Name of the new TransportRule to be created by the script.

# -WordListFile (required)
# File Path for List of bad words to check.

# -RejectionReason (Optional)
# Message that end users get when they try to send email to each other

# -ExceptForMembersOf (Optional)
# The groups which have exception to skip the check.

# -RemoteURL (required)
# URL for the connection to the Remote Powershell environment.

# -LiveCredential (required)
# Credentials fot the basic auth logon to the Remote Powershell environment.

# -------------------------- EXAMPLE --------------------------

# Populate credentials to variable:
# $cred = Get-Credential
# -or-
# $Username = "admin@mydomain.com"
# $Password = ConvertTo-SecureString 'MyPassword' -AsPlainText -Force
# $cred = New-Object System.Management.Automation.PSCredential $Username, $Password

# .\ManageProfanityFilter.ps1 "Harassment Policy a-h" -WordListFile "English Profanity List a-h.txt" -RejectionReason "This message cannot be delivered because it contains inappropriate content as defined in the Harassment Policy." -ExceptForMembersOf Admins -RemoteURL https://ps.exchangelabs.com/powershell/ -LiveCredential $cred