Get-WsusServer

NAME Get-WsusServer



SYNOPSIS

Gets the WSUS update server object.





SYNTAX

Get-WsusServer [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable <System.String>]

[<CommonParameters>]



Get-WsusServer [-Name] <String> [-InformationAction {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable

<System.String>] [-UseSsl] -PortNumber <Int32> [<CommonParameters>]





DESCRIPTION

The Get-WsusServer cmdlet gets the Windows Server Update Services (WSUS) update server object. This cmdlet requires the server name, port number

and a flag that specifies if the server uses Secure Sockets Layer (SSL) as parameters.



Given a server name, port number, and flag specifying whether to use SSL, returns an IUpdateServer object.





PARAMETERS

-InformationAction [<System.Management.Automation.ActionPreference>]

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:



-- Continue

-- Ignore

-- Inquire

-- SilentlyContinue

-- Stop

-- Suspend



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-InformationVariable [<System.String>]

Specifies an information variable.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Name <String>

Specifies the name of a WSUS server.



Required? true

Position? 1

Default value none

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-PortNumber <Int32>

Specifies the port number to use to communicate with the upstream WSUS server.



Required? true

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-UseSsl [<SwitchParameter>]

Specifies that the WSUS server should use Secure Sockets Layer (SSL) via HTTPS to communicate with an upstream server.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None







OUTPUTS

Microsoft.UpdateServices.Commands.IUpdateServer









Example 1: Get the local server



PS C:\\> Get-WsusServer

Name : contoso



This command gets the IUpdateServer object for the local computer.





Example 2: Get a remote server



PS C:\\> Get-WsusServer -Name "contoso" -PortNumber 8530

Name : contoso



This command gets the IUpdateServer object for a remote computer.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=287830