New-CMSecondarySite
Updated: March 1, 2013
Applies To: System Center 2012 Configuration Manager SP1
New-CMSecondarySite
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.
