functions/Disconnect-SPRSite.ps1
|
Function Disconnect-SPRSite { <# .SYNOPSIS Disconnects a SharePoint Client Context object that lets you use and manage the site collection in Windows PowerShell. .DESCRIPTION Disconnects a SharePoint Client Context object that lets you use and manage the site collection in Windows PowerShell. .PARAMETER Site The address to the site collection. You can also pass a hostname and it'll figure it out. .PARAMETER Credential Provide alternative credentials to the site collection. Otherwise, it will use default credentials. .PARAMETER InputObject Allows piping of server/spsite objects .PARAMETER EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with "sea of red" exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this "nice by default" feature off and enables you to catch exceptions with your own try/catch. .EXAMPLE Disconnect-SPRSite -Site intranet.ad.local Disconnects from intranet.ad.local by disposing the global variable .EXAMPLE Disconnect-SPRSite -Site https://intranet.ad.local/ Creates a web service object for intranet.ad.local using the formal and complete address. .EXAMPLE Disconnect-SPRSite -Site intranet.ad.local -Credential ad\user Creates a web service object and logs into the webapp as ad\user. #> [CmdletBinding()] param ( [Parameter(HelpMessage = "SharePoint Site Collection")] [string]$Site, [PSCredential]$Credential, [parameter(ValueFromPipeline)] [object]$InputObject, [switch]$EnableException ) process { if (-not $InputObject) { if ($Site) { Write-PSFMessage -Level Verbose -Message "Connecting to the SharePoint service at $Site" $InputObject = Connect-SPRSite -Site $Site -Credential $Credential } elseif ($global:spsite) { $InputObject = $global:spsite } else { Stop-PSFFunction -EnableException:$EnableException -Message "You must specify Site or run Connect-SPRSite" return } } try { Write-PSFMessage -Level Verbose -Message "Disconnecting to the SharePoint service at $($InputObject.Url)" $output = [pscustomobject]@{ Url = $global:spsite.Url ServerVersion = $global:spsite.ServerVersion AuthenticationMode = $global:spsite.AuthenticationMode Credential = $global:spsite.Credential Disconnected = $true } $global:spsite.Dispose() Remove-Variable -Name spsite -Scope Global Select-Object -InputObject $output } catch { Stop-PSFFunction -EnableException:$EnableException -Message "Failure" -ErrorRecord $_ -Continue } } } |