kbupdate

2.0.2

library/PoshWSUS/2.3.1.6/Scripts/Connect-PSWSUSServer.ps1

Function Connect-PSWSUSServer {
    <#
    .SYNOPSIS
        Make the initial connection to a WSUS Server.
         
    .DESCRIPTION
        Make the initial connection to a WSUS Server. Only one concurrent connection is allowed.
         
    .PARAMETER WsusServer
        Name of WSUS server to connect to. If not value is given, an attempt to read the value from registry will occur.
               
    .PARAMETER SecureConnection
        Determines if a secure connection will be used to connect to the WSUS server. If not used, then a non-secure
        connection will be used.
          
    .PARAMETER Port
        Port number to connect to. Default is Port "80" if not used. Accepted values are "80","443","8350" and "8351"
            
    .NOTES
        Name: Connect-PSWSUSServer
        Author: Boe Prox
        Version History:
            1.2 | 17 Feb 2015
                -Renamed to Connect-PSWSUSServer
                -Allow read of registry for WUServer and Port
            1.0 | 24 Sept 2010
                -Initial Version
                
    .LINK
        https://learn-powershell.net
 
    .EXAMPLE
    Connect-PSWSUSServer -WSUSserver "server1"
 
    Description
    -----------
    This command will make the connection to the WSUS using an unsecure port (Default:80).
    .EXAMPLE
    Connect-PSWSUSServer -WSUSserver "server1" -SecureConnection
 
    Description
    -----------
    This command will make a secure connection (Default: 443) to a WSUS server.
    .EXAMPLE
    Connect-PSWSUSServer -WSUSserver "server1" -port 8530
 
    Description
    -----------
    This command will make the connection to the WSUS using a defined port 8530.
            
    #> 
    [cmdletbinding()]
        Param(
            [Parameter(ValueFromPipeline = $True)]
            [Alias('Computername')]
            [string]$WsusServer, 
                                
            [Parameter()]
            [switch]$SecureConnection, 
              
            [Parameter()]
            [ValidateSet("80","443","8530","8531" )] 
            [int]$Port = 80                                
        )   
    Begin {                         
        $ErrorActionPreference = 'Stop'
        If ($PSBoundParameters['SecureConnection']) {
            $Secure = $True
        } Else {
            $Secure = $False
        }
    }
    Process {
        If (-NOT $PSBoundParameters.ContainsKey('WSUSServer')) {
            #Attempt to pull WSUS server name from registry key to use
            If ((Get-ItemProperty -Path HKLM:\Software\Policies\Microsoft\Windows\WindowsUpdate -Name WUServer).WUServer -match '(?<Protocol>^http(s)?)(?:://)(?<Computername>(?:(?:\w+(?:\.)?)+))(?::)?(?<Port>.*)') {
                $WsusServer = $Matches.Computername
                $Port = $Matches.Port
            }
        }
        #Make connection to WSUS server
        Try {
            Write-Verbose "Connecting to $($WsusServer) <$($Port)>"
            $Script:Wsus = [Microsoft.UpdateServices.Administration.AdminProxy]::GetUpdateServer($wsusserver,$Secure,$port)  
            $Script:_wsusconfig = $Wsus.GetConfiguration()
            Write-Output $Wsus  
        } Catch {
            Write-Warning "Unable to connect to $($wsusserver)!`n$($error[0])"
        } Finally {
            $ErrorActionPreference = 'Continue' 
        } 
    }          
}