Share via

New-CMSiteSystemServer

  • Article

New-CMSiteSystemServer

Creates an object that represents a site system server in Configuration Manager.

Syntax

Parameter Set: New
New-CMSiteSystemServer -ServerName <String> -SiteCode <String> [-AccountName <String> ] [-EnableProxy <Boolean> ] [-FdmOperation <Boolean> ] [-ProxyAccessAccount <IResultObject> ] [-ProxyServerName <String> ] [-ProxyServerPort <UInt32> ] [-PublicFqdn <String> ] [-UseSiteServerAccount] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The New-CMSiteSystemServer cmdlet creates an object that represents a site system server in Microsoft System Center 2012 SP1 Configuration Manager. A site system server provides functionality to a configuration management site, such as communication between a System Center 2012 Configuration Manager server and System Center 2012 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.

Parameters

-AccountName<String>

Specifies an account name for the Configuration Manager site.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-EnableProxy<Boolean>

Indicates whether to enable a proxy server.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-FdmOperation<Boolean>

Indicates whether a site system pushes information back to a site server, or whether a site server pushes information to a site system.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProxyAccessAccount<IResultObject>

Specifies an input object that contains the domain and user name to authenticate with the proxy server. Do not use user principal name (UPN) format.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProxyServerName<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProxyServerPort<UInt32>

Specifies the port number of a proxy server to use to connect to the Internet.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PublicFqdn<String>

Specifies a fully qualified domain name (FQDN) path for the Configuration Manager site.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ServerName<String>

Specifies a server name for the Configuration Manager site.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies a site code for the Configuration Manager site.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UseSiteServerAccount

Indicates that the cmdlet uses a user account name for the site.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before running the cmdlet.

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

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

Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Create a new site system server

This command creates a new site system server with the server name and site parameters.

PS C:\> New-CMSiteSystemServer -ServerName "ContosoSvr02" -SiteCode "CM2"

Get-CMSiteSystemServer

Set-CMSiteSystemServer