PoshCode Archive  Artifact Content

Artifact 74ed2156ae72ec6cde50f416573eff232118a11875a60b3f210c241557504cb4:

  • File Set-SendAs.ps1 — part of check-in [80a184eded] at 2018-06-10 14:06:12 on branch trunk — Set the Send As permissions on an exchange 2007 mailbox. (user: Jon Webster size: 2263)

# encoding: ascii
# api: powershell
# title: Set-SendAs
# description: Set the Send As permissions on an exchange 2007 mailbox.
# version: 0.1
# type: function
# author: Jon Webster
# license: CC0
# function: Set-SendAs
# x-poshcode-id: 602
# x-archived: 2012-12-15T05:01:37
# x-published: 2008-09-23T23:58:00
#
#
# NAME
#   Set-SendAs
#
# SYNOPSIS
#   Use the Set-SendAs cmdlet to grant or Remove SendAs permissions on a mailbox
#
# SYNTAX
#   Set-SendAs -Identity <MailboxIdParameter> -SendAs <MailboxIdParameter> -ou <OrganizationalUnit> [-Remove <SwitchParameter> [-Confirm [<SwitchParameter>]]] [-DomainController <Fqdn>]

Function Set-SendAs ($Identity, $SendAs, $ou, [Switch]$Remove, $DomainController = "dc01", [switch]$Confirm = $true)
{
	PROCESS
	{
		if(!$ou) {throw 'Required paramater $ou is missing.'}

		# Use pipeline input when parameter is not specified
		if($_)
		{
			if($_.Identity -and !$Identity) {$Identity = $_.Identity}
			if($_.SendAs -and !$SendAs) {$SendAs = $_.SendAs}
			if($_.ou -and !$ou) {$ou = $_.ou}
			if($_.remove -and !$remove) {$remove = $_.remove}
		}
		
		# Verify admin and user are both available
		$IdentityMbx = $Identity
		$SendAsMbx = $SendAs

		if([string]$Identity.GetType() -ne "Microsoft.Exchange.Data.Directory.Management.Mailbox" -and !($IdentityMbx = Get-Mailbox $Identity -DomainController $DomainController -OrganizationalUnit $ou -ErrorAction SilentlyContinue))
		{throw "The operation could not be performed becaues the object '$Identity' could not be found in the organization '$ou'"}

		if([string]$SendAs.GetType() -ne "Microsoft.Exchange.Data.Directory.Management.Mailbox" -and !($SendAsMbx = Get-Mailbox $SendAs -DomainController $DomainController -OrganizationalUnit $ou -ErrorAction SilentlyContinue))
		{throw "The operation could not be performed becaues the object '$SendAs' could not be found in the organization '$ou'"}

		# Make changes
		If(!$Remove) {$null = Add-ADPermission -Identity $IdentityMbx.DistinguishedName -User $SendAsMbx.DistinguishedName -ExtendedRights Send-As}
		Else {$null = Remove-ADPermission -Identity $IdentityMbx.DistinguishedName -User $SendAsMbx.DistinguishedName -ExtendedRights Send-As -Confirm:$Confirm}
	}
}