New-CMSecondarySite

New-CMSecondarySite

Creates a secondary site in Configuration Manager.

構文

Parameter Set: NewDistributionPointByHTTPAndCreateCertificate
New-CMSecondarySite -CertificateExpirationTimeUtc <DateTime> -CreateSelfSignedCertificate -Http -InstallationSourceFile <IResultObject[]> -InstallInternetServer <Boolean> -ParentSiteCode <String> -ServerName <String> -SiteCode <String> -SiteName <String> -SqlServerSetting <IResultObject[]> [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-BoundaryGroups <IResultObject[]> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PrimaryContentLibraryLocation <DriveType> {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} ] [-PrimaryPackageShareLocation <DriveType> {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} ] [-SecondaryContentLibraryLocation <DriveType> {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} ] [-SecondaryPackageShareLocation <DriveType> {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} ] [-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[]> [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-BoundaryGroups <IResultObject[]> ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-EnableAnonymous <Boolean> ] [-ForceWhenDuplicateCertificate <Boolean> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PrimaryContentLibraryLocation <DriveType> {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} ] [-PrimaryPackageShareLocation <DriveType> {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} ] [-SecondaryContentLibraryLocation <DriveType> {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} ] [-SecondaryPackageShareLocation <DriveType> {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} ] [-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[]> [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-BoundaryGroups <IResultObject[]> ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PrimaryContentLibraryLocation <DriveType> {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} ] [-PrimaryPackageShareLocation <DriveType> {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} ] [-SecondaryContentLibraryLocation <DriveType> {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} ] [-SecondaryPackageShareLocation <DriveType> {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} ] [-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[]> [-AllowFallbackForContent <Boolean> ] [-AllowPreStaging <Boolean> ] [-BoundaryGroups <IResultObject[]> ] [-ClientConnectionType <ClientConnectionTypes> {Internet | InternetAndIntranet | Intranet} ] [-ContentMonitoringPriority <Priority> {High | Highest | Low | Lowest | Medium} ] [-ForceWhenDuplicateCertificate <Boolean> ] [-InstallationFolder <String> ] [-MinFreeSpaceMB <Int32> ] [-PrimaryContentLibraryLocation <DriveType> {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} ] [-PrimaryPackageShareLocation <DriveType> {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} ] [-SecondaryContentLibraryLocation <DriveType> {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} ] [-SecondaryPackageShareLocation <DriveType> {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} ] [-ValidateContentSchedule <IResultObject> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

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

パラメーター

-AllowFallbackForContent<Boolean>

Indicates whether clients can use a fallback source location for content.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-AllowPreStaging<Boolean>

Indicates whether the secondary site can pre-stage contents.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-BoundaryGroups<IResultObject[]>

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

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-CertificateExpirationTimeUtc<DateTime>

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-CertificatePassword<SecureString>

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	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.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ClientConnectionType<ClientConnectionTypes>

Specifies a client connection type. Valid values are:

-- Internet
-- InternetAndIntranet
-- Intranet

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ContentMonitoringPriority<Priority>

Specifies content monitoring priority. Valid values are:

-- High
-- Highest
-- Low
-- Lowest
-- Medium

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-CreateSelfSignedCertificate

Indicates that the secondary site creates a self-signed certificate.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	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.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ForceWhenDuplicateCertificate<Boolean>

Indicates whether Configuration Manager overwrites a duplicate certificate when you import a PKI client certificate for the secondary site.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-Http

Indicates that 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.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-Https

Indicates that 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.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ImportCertificate

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-InstallationFolder<String>

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

エイリアス	InstallDir
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-InstallationSourceFile<IResultObject[]>

Specifies an array of installation source file objects for Configuration Manager. To obtain an installation source file object, use the New-CMInstallationSourceFile cmdlet.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	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.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	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.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ParentSiteCode<String>

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-PrimaryContentLibraryLocation<DriveType>

Specifies a primary content library location. Valid values are:

-- Automatic.
-- Drive letter from A: through Z:.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-PrimaryPackageShareLocation<DriveType>

Specifies a primary package share location. Valid values are:

-- Automatic.
-- Drive letter from A: through Z:.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SecondaryContentLibraryLocation<DriveType>

Specifies a secondary content library location. Valid values are:

-- Automatic.
-- Drive letter from A: through Z:.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SecondaryPackageShareLocation<DriveType>

Specifies a secondary package share location. Valid values are:

-- Automatic.
-- Drive letter from A: through Z:.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-ServerName<String>

Specifies an FQDN for the secondary site server.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SiteCode<String>

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

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SiteName<String>

Specifies the site name that helps identify the secondary site.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-SqlServerSetting<IResultObject[]>

Specifies an array of SQL Server settings object in Configuration Manager. To obtain a SQL Server settings object, use the New-CMSqlServerSetting cmdlet.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	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.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	True (ByPropertyName)
ワイルドカード文字を許可する	false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?	false
位置は?	named
既定値	false
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Create a secondary site

This first command creates a SQL Server settings object and specifies that Microsoft SQL Server Express is copied to a Configuration Manager secondary site. The command stores the object in the $CIObj variable.

The second command creates a secondary site named Contoso remote site that has the site code CM2 on the server named server2.corp.contoso.com. The command specifies the SQL Server settings object for the secondary sited stored in $CIObj. The command specifies the primary site for the secondary site that has the site code CM1.

PS C:\> $CIObj = New-CMSqlServerSetting -CopySqlServerExpressOnSecondarySite
PS C:\> New-CMSecondarySite -CertificateExpirationTimeUtc "2/1/2020 12:00 AM" -CreateSelfSignedCertificate -Https -InstallationSourceFile "\\ContosoServer1\SourceFiles" -InstallInternetServer $True -ParentSiteCode "CM1" -ServerName "server2.corp.contoso.com" -SiteCode "CM2" -SiteName "Contoso remote site" -SqlServerSetting $CIObj

関連トピック

Remove-CMSecondarySite

New-CMInstallationSourceFile

New-CMSqlServerSetting