Remove-SCUpdateServer

Removes a Windows Server Update Services computer from VMM.

Description

The Remove-SCUpdateServer cmdlet removes a Microsoft Windows Server Update Services (WSUS) computer from Sytem Center Virtual Machine Manager (VMM). Removing WSUS integration disables the update management feature in VMM.

For more information about Remove-SCUpdateServer, type: "Get-Help Remove-SCUpdateServer -online".

Parameters

UpdateServer

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0 
Specifies a VMM update server object.

Credential

Required? true
Accept Pipeline Input? false
Position? named 
Specifies a credential object or, for some cmdlets, a Run As account object that contains the user name and password of an account that has permission to perform this action. Or, in the case of Restart-SCJob, has permission to complete a restarted task. 

For more information about the PSCredential object, type: "Get-Help Get-Credential". 
For more information about Run As accounts, type: "Get-Help New-SCRunAsAccount".

Confirm

Required? false
Accept Pipeline Input? false
Position? named 
Prompts for confirmation before running the command.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named 
Specifies that job progress is tracked and stored in the variable named by this parameter.

PROTipID

Required? false
Accept Pipeline Input? false
Position? named 
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named 
Indicates that the job runs asynchronously so that control returns to the command shell immediately.

VMMServer

Required? false
Accept Pipeline Input? true (ByValue)
Position? named 
Specifies a VMM server object.

Examples

1: Remove an update server. 
PS C:\> $Credential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $UpdateServer = Get-SCUpdateServer -ComputerName "WSUSComputer01"
PS C:\> Remove-SCUpdateServer –UpdateServer $UpdateServer -Credential $Credential

The first command uses the Get-Credential cmdlet to prompt you to supply a user name and password and stores the credentials in the $Credential variable. 

The second command gets the update server object named WSUSComputer01 and stores the object in the $UpdateServer variable.

The last command removes the update server stored in $UpdateServer, in this case, WSUSComputer01.

See Also