New-CMSiteSystemServer

Creates a site system server.

Syntax

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

Description

The New-CMSiteSystemServer cmdlet creates a site system server in Microsoft System Center Configuration Manager. A site system server provides functionality to a configuration management site, such as communication between a Configuration Manager server and Configuration Manager clients. You can designate a new server as a site system server and add the site system roles, or install site system roles to an existing site system server in the site.

Examples

Example 1: Create a site system server

PS C:\> New-CMSiteSystemServer -SiteSystemServerName "Server1.contoso.com" -SiteCode "MP5" -PublicFqdn "Internetsrv1.contoso.com" -FdmOperation $True -UseSiteServerAccount -EnableProxy $True -ProxyServerName "ProxyServer1" -ProxyServerPort 80 -ProxyAccessAccount (Get-CMAccount "contoso\administrator")

This command creates a site system server with the name Server1.contoso.com. The site system server uses the proxy server named ProxyServer1 to connect to the Internet using port 80.

Required Parameters

-SiteSystemServerName

Specifies a name for the site system server.

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

Optional Parameters

-AccountName

Specifies an account name to use to install the site system server.

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 synchronizing 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 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
-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 fully qualified domain name (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 for 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 computer account of the site server 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