Set-CMSiteSystemServer

Modifies a site system server.

Syntax

Set-CMSiteSystemServer
   [-AccountName <String>]
   [-Confirm]
   [-DisableWildcardHandling]
   [-EnableProxy <Boolean>]
   [-FdmOperation <Boolean>]
   [-ForceWildcardHandling]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProxyAccessAccount <IResultObject>]
   [-ProxyServerName <String>]
   [-ProxyServerPort <UInt32>]
   [-PublicFqdn <String>]
   [-UseSiteServerAccount]
   [-WhatIf]
   [<CommonParameters>]
Set-CMSiteSystemServer [-SiteSystemServerName]  [-AccountName ] [-Confirm]
 [-DisableWildcardHandling] [-EnableProxy ] [-FdmOperation ] [-ForceWildcardHandling]
 [-PassThru] [-ProxyAccessAccount ] [-ProxyServerName ] [-ProxyServerPort ]
 [-PublicFqdn ] [-SiteCode ] [-UseSiteServerAccount] [-WhatIf] []

Description

The Set-CMSiteSystemServer cmdlet modifies a site system server in Microsoft System Center Configuration Manager.

Examples

Example 1: Modify a site system server by using the pipeline operator

PS C:\> Get-CMSiteSystemServer -Name "Server2.contoso.com" -SiteCode MP5 | Set-CMSiteSystemServer -SiteCode MP5 -PublicFqdn "Internetsrv2New.contoso.com" -FdmOperation $False -AccountName "contoso\administrator" -EnableProxy $True -ProxyServerName "ProxyServer1" -ProxyServerPort 80 -ProxyAccessAccount (Get-CMAccount "contoso\administrator") -PassThru

This command gets the site system server object named Server2.contoso.com with the site code MP5 and uses the pipeline operator to pass the object to Set-CMSiteSystemServer. Set-CMSiteSystemServer adds an FQDN to the site system server to use on the Internet, and enables a proxy server named ProxyServer1 to connect to the Internet using port 80.

Example 2: Modify a site system server

PS C:\> Set-CMSiteSystemServer -SiteSystemServerName "Server2.contoso.com" -SiteCode "MP5" -PublicFqdn "Internetsrv2New.contoso.com" -FdmOperation $False -AccountName "contoso\administrator" -EnableProxy $True -ProxyServerName "ProxyServer1" -ProxyServerPort 80 -ProxyAccessAccount (Get-CMAccount "contoso\administrator") -PassThru

This command gets the site system server object named Server2.contoso.com with the site code MP5, adds an FQDN to the site system server to use on the Internet, and enables a proxy server named ProxyServer1 to connect to the Internet using port 80.

Required Parameters

-InputObject

Specifies a site system server object. To obtain a site system server object, use the Get-CMSiteSystemServer cmdlet.

Type:IResultObject
Aliases:SiteSystemServer
Required:True
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-SiteSystemServerName

Specifies a server name for the site system.

Type:String
Aliases:Name, ServerName
Required:True
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-AccountName

Specifies the account name for the site system.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-EnableProxy

Indicates whether to enable a proxy server to use when the server synchronizes information from the Internet.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FdmOperation

Indicates whether the site system server is required to initiate connections to this site system.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyAccessAccount

Specifies the credentials to use to authenticate with the proxy server. Do not use user principal name (UPN) format.

Type:IResultObject
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyServerName

Specifies the name of a proxy server. Use a fully qualified domain name (FQDN), short name, or IPv4/IPv6 address.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProxyServerPort

Specifies the proxy server port number to use when connecting to the Internet.

Type:UInt32
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PublicFqdn

Specifies a FQDN for the site system for use on the Internet.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the site code of a Configuration Manager site.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UseSiteServerAccount

Indicates that the cmdlet uses the site server's computer account to install the site system.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

IResultObject#SMS_SCI_SysResUse