Expand Minimize
This topic has not yet been rated - Rate this topic

New-CMSecondarySite

Updated: March 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

New-CMSecondarySite

Creates a secondary site in Configuration Manager.

Syntax

Parameter Set: NewDistributionPointByHTTPAndCreateCertificate
New-CMSecondarySite -CertificateExpirationTimeUtc <DateTime> -CreateSelfSignedCertificate -Http -InstallationSourceFile <IResultObject[]> -InstallInternetServer <Boolean> -ParentSiteCode <String> -ServerName <String> -SiteCode <String> -SiteName <String> -SqlServerSetting <IResultObject[]> [-BoundaryGroups <IResultObject[]> ] [-BoundaryGroupsProtected <Boolean> ] [-ContentMonitoringPriority <Priority> ] [-EnableAnonymous <Boolean> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PreStagingAllowed <Boolean> ] [-PrimaryContentLibraryLocation <DriveType> ] [-PrimaryPackageShareLocation <DriveType> ] [-SecondaryContentLibraryLocation <DriveType> ] [-SecondaryPackageShareLocation <DriveType> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewDistributionPointByHTTPAndImportCertificate
New-CMSecondarySite -CertificatePassword <SecureString> -CertificatePath <String> -Http -ImportCertificate -InstallationSourceFile <IResultObject[]> -InstallInternetServer <Boolean> -ParentSiteCode <String> -ServerName <String> -SiteCode <String> -SiteName <String> -SqlServerSetting <IResultObject[]> [-BoundaryGroups <IResultObject[]> ] [-BoundaryGroupsProtected <Boolean> ] [-ContentMonitoringPriority <Priority> ] [-EnableAnonymous <Boolean> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PreStagingAllowed <Boolean> ] [-PrimaryContentLibraryLocation <DriveType> ] [-PrimaryPackageShareLocation <DriveType> ] [-SecondaryContentLibraryLocation <DriveType> ] [-SecondaryPackageShareLocation <DriveType> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewDistributionPointByHTTPSAndCreateCertificate
New-CMSecondarySite -CertificateExpirationTimeUtc <DateTime> -CreateSelfSignedCertificate -Https -InstallationSourceFile <IResultObject[]> -InstallInternetServer <Boolean> -ParentSiteCode <String> -ServerName <String> -SiteCode <String> -SiteName <String> -SqlServerSetting <IResultObject[]> [-BoundaryGroups <IResultObject[]> ] [-BoundaryGroupsProtected <Boolean> ] [-ClientConnectionType <ClientConnectionTypes> ] [-ContentMonitoringPriority <Priority> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PreStagingAllowed <Boolean> ] [-PrimaryContentLibraryLocation <DriveType> ] [-PrimaryPackageShareLocation <DriveType> ] [-SecondaryContentLibraryLocation <DriveType> ] [-SecondaryPackageShareLocation <DriveType> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewDistributionPointByHTTPSAndImportCertificate
New-CMSecondarySite -CertificatePassword <SecureString> -CertificatePath <String> -Https -ImportCertificate -InstallationSourceFile <IResultObject[]> -InstallInternetServer <Boolean> -ParentSiteCode <String> -ServerName <String> -SiteCode <String> -SiteName <String> -SqlServerSetting <IResultObject[]> [-BoundaryGroups <IResultObject[]> ] [-BoundaryGroupsProtected <Boolean> ] [-ClientConnectionType <ClientConnectionTypes> ] [-ContentMonitoringPriority <Priority> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PreStagingAllowed <Boolean> ] [-PrimaryContentLibraryLocation <DriveType> ] [-PrimaryPackageShareLocation <DriveType> ] [-SecondaryContentLibraryLocation <DriveType> ] [-SecondaryPackageShareLocation <DriveType> ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The New-CMSecondarySite cmdlet creates a secondary site in Microsoft System Center 2012 Configuration Manager.

Parameters

-BoundaryGroups<IResultObject[]>

Specifies an array of boundary group objects. To get a boundary group object, use the Get-CMBoundaryGroup cmdlet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-BoundaryGroupsProtected<Boolean>

Indicates whether you assign the boundary groups to protected distribution points. A protected distribution point is accessible only to clients within the assigned boundary group.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificateExpirationTimeUtc<DateTime>

Specifies the date and time at which the self-signed certificate expires for a distribution point on this secondary site.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificatePassword<SecureString>

Specifies the password for the PKI imported certificate for the distribution point.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CertificatePath<String>

Specifies the import path for the PKI issued certificate that the distribution point uses. This parameter applies when the secondary site has installed and configured IIS to create a distribution point,


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ClientConnectionType<ClientConnectionTypes>

Specifies a client connection type. This value can be Internet, Intranet, or InternetAndIntranet.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ContentMonitoringPriority<Priority>

Specifies…Acceptable values are High, Highest, Low, Lowest, and Medium.
-- High:
-- Highest:
-- Low:
-- Lowest:
-- Medium:


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CreateSelfSignedCertificate

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-EnableAnonymous<Boolean>

Indicates whether client computers communicate anonymously with the distribution point. This parameter applies when the secondary site has installed and configured IIS to create a distribution point.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Http

Indicates whether client computers communicate with the distribution point by using HTTP. This parameter applies when the secondary site has installed and configured IIS to create a distribution point. This option does not support mobile devices or Mac computers.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Https

Indicates whether client computers communicate with the distribution point by using HTTPS. This parameter applies when the secondary site has installed and configured IIS to create a distribution point. This option does not support mobile devices or Mac computers.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ImportCertificate

Indicates that the cmdlet imports a PKI certificate instead of using a self-signed certificate for the distribution point.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InstallationFolder<String>

Specifies the installation folder on the secondary site server where the cmdlet installs the site’s files.


Aliases

InstallDir

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InstallationSourceFile<IResultObject[]>

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InstallInternetServer<Boolean>

Specifies whether to install and configure IIS if Configuration Manager requires it. This parameter must be $True before the cmdlet can install the site system role for the distribution point on this secondary site.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MinFreeSpaceMB<Int32>

Specifies the amount of space, in megabytes, to reserve on each drive that the distribution point uses. This value determines the remaining free space on the drive after the distribution stores content on the drive.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ParentSiteCode<String>

Specifies the site code of the primary site that is parent to the secondary site that the cmdlet creates.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PreStagingAllowed<Boolean>

Indicates whether the cmdlet enables prestaged content for distribution points on the secondary site that the cmdlet creates.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrimaryContentLibraryLocation<DriveType>

Specifies…Acceptable values are A, Automatic, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, and Z.
-- A:
-- Automatic:
-- B:
-- C:
-- D:
-- E:
-- F:
-- G:
-- H:
-- I:
-- J:
-- K:
-- L:
-- M:
-- N:
-- O:
-- P:
-- Q:
-- R:
-- S:
-- T:
-- U:
-- V:
-- W:
-- X:
-- Y:
-- Z:


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrimaryPackageShareLocation<DriveType>

Specifies…Acceptable values are A, Automatic, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, and Z.
-- A:
-- Automatic:
-- B:
-- C:
-- D:
-- E:
-- F:
-- G:
-- H:
-- I:
-- J:
-- K:
-- L:
-- M:
-- N:
-- O:
-- P:
-- Q:
-- R:
-- S:
-- T:
-- U:
-- V:
-- W:
-- X:
-- Y:
-- Z:


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecondaryContentLibraryLocation<DriveType>

Specifies…Acceptable values are A, Automatic, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, and Z.
-- A:
-- Automatic:
-- B:
-- C:
-- D:
-- E:
-- F:
-- G:
-- H:
-- I:
-- J:
-- K:
-- L:
-- M:
-- N:
-- O:
-- P:
-- Q:
-- R:
-- S:
-- T:
-- U:
-- V:
-- W:
-- X:
-- Y:
-- Z:


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SecondaryPackageShareLocation<DriveType>

Specifies…Acceptable values are A, Automatic, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q, R, S, T, U, V, W, X, Y, and Z.
-- A:
-- Automatic:
-- B:
-- C:
-- D:
-- E:
-- F:
-- G:
-- H:
-- I:
-- J:
-- K:
-- L:
-- M:
-- N:
-- O:
-- P:
-- Q:
-- R:
-- S:
-- T:
-- U:
-- V:
-- W:
-- X:
-- Y:
-- Z:


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ServerName<String>

Specifies a FQDN for the secondary site server.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the site code that uniquely identifies the secondary site in the hierarchy.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteName<String>

Specifies the site name that helps identify the secondary site.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SqlServerSetting<IResultObject[]>

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ValidateContentSchedule<IResultObject>

Specifies an object that represents a schedule type and determines how frequently System Center 2012 Configuration Manager validates the integrity of packages on the distribution point.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


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.

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.

Related topics

 
Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.