New-CMSecondarySite

モジュール:

ConfigurationManager

セカンダリ サイトを作成します。

構文

New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificateExpirationTimeUtc <DateTime>
   [-ContentMonitoringPriority <Priority>]
   [-CreateSelfSignedCertificate]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache]
   [-Http]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificateExpirationTimeUtc <DateTime>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-CreateSelfSignedCertificate]
   [-EnableBranchCache]
   [-Https]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-EnableBranchCache]
   [-ForceWhenDuplicateCertificate <Boolean>]
   [-Https]
   [-ImportCertificate]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMSecondarySite
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-BoundaryGroup <IResultObject[]>]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ContentMonitoringPriority <Priority>]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache]
   [-ForceWhenDuplicateCertificate <Boolean>]
   [-Http]
   [-ImportCertificate]
   [-InstallationFolder <String>]
   -InstallationSourceFile <IResultObject[]>
   [-InstallInternetServer <Boolean>]
   [-MinFreeSpaceMB <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PrimarySiteCode <String>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   -SecondarySiteCode <String>
   -ServerName <String>
   -SiteName <String>
   -SqlServerSetting <IResultObject[]>
   [-ValidateContentSchedule <IResultObject>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMSecondarySite コマンドレットは、セカンダリ サイトを作成します。 詳細については、「Configuration Manager サイトを インストールする準備」を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: セカンダリ サイトを作成する

この最初のコマンドは、ユーザー設定SQL Server作成します。 このオブジェクトは、構成マネージャー Microsoft SQL Server Expressサイトにコピーするオブジェクトを指定します。 このコマンドは、オブジェクトを変数 $CIObjします 。

2 番目のコマンドは 、Contosoリモート サイトという名前のセカンダリ サイトを作成し、サイト コードCM2がサーバーにserver2.corp.contoso.com。 このコマンドは、SQL Serverに格納されているセカンダリ サイトの設定オブジェクトを$CIObj。 このコマンドは、サイト コード CM1 を持つセカンダリ サイトのプライマリ サイトを 指定します。

$CIObj = New-CMSqlServerSetting -CopySqlServerExpressOnSecondarySite

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

パラメーター

-AllowFallbackForContent

クライアントがコンテンツにフォールバック ソースの場所を使用できるかどうかを示します。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPreStaging

セカンダリ サイトがコンテンツを事前設定できるかどうかを示します。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BoundaryGroup

このサイト システムの境界グループ オブジェクトの配列を指定します。 このオブジェクトを取得するには 、Get-CMBoundaryGroup コマンドレットを使用 します。

Type:	IResultObject[]
Aliases:	BoundaryGroups
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateExpirationTimeUtc

セカンダリ サイトの配布ポイントの自己署名証明書の有効期限が切れる日時を指定します。

Type:	DateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePassword

配布ポイントの PKI インポート証明書のパスワードを指定します。

Type:	SecureString
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePath

配布ポイントが使用する PKI 発行証明書のインポート パスを指定します。 このパラメーターは、セカンダリ サイトが配布ポイントを作成するように IIS をインストールして構成した場合に適用されます。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientConnectionType

クライアント接続の種類を指定します。

Type:	ClientConnectionTypes
Accepted values:	Intranet, Internet, InternetAndIntranet
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentMonitoringPriority

コンテンツ監視の優先度を指定します。

Type:	Priority
Accepted values:	Lowest, Low, Medium, High, Highest
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CreateSelfSignedCertificate

セカンダリ サイトが配布ポイントの自己署名証明書を作成します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAnonymous

クライアント コンピューターが配布ポイントと匿名で通信するかどうかを示します。 このパラメーターは、セカンダリ サイトが配布ポイントを作成するように IIS をインストールして構成した場合に適用されます。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableBranchCache

BranchCache を使用するWindowsは、オンプレミス配布ポイントからコンテンツをダウンロードできます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWhenDuplicateCertificate

セカンダリ サイトの PKI クライアント証明書をインポートするときに、Configuration Manager が重複する証明書を上書きするかどうかを示します。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Http

クライアント コンピューターが HTTP を使用して配布ポイントと通信します。 このパラメーターは、セカンダリ サイトが配布ポイントを作成するように IIS をインストールして構成した場合に適用されます。 \

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Https

クライアント コンピューターが HTTPS を使用して配布ポイントと通信するように指定します。 このパラメーターは、セカンダリ サイトが配布ポイントを作成するように IIS をインストールして構成した場合に適用されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ImportCertificate

コマンドレットが配布ポイントに自己署名証明書を使用する代わりに PKI 証明書をインポートします。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallationFolder

コマンドレットがサイト ファイルをインストールするセカンダリ サイト サーバー上のインストール フォルダーを指定します。

Type:	String
Aliases:	InstallDir
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallationSourceFile

Configuration Manager のインストール ソース ファイル オブジェクトの配列を指定します。 このオブジェクトを取得するには 、New-CMInstallationSourceFile コマンドレットを使用 します。

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallInternetServer

Configuration Manager で IIS が必要な場合に IIS をインストールして構成するかどうかを指定します。 このパラメーターは、コマンドレットがセカンダリ サイト上の配布ポイントのサイト システムの役割をインストールする前 $True に指定する必要があります。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MinFreeSpaceMB

配布ポイントが使用する各ドライブで予約する領域の量をメガバイト単位で指定します。 この値は、配布がドライブにコンテンツを格納した後、ドライブの残りの空き領域を決定します。

バージョン 2107 から、既定の最小空き領域が 200 MB から 500 MB に変更されました。

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryContentLibraryLocation

プライマリ コンテンツ ライブラリの場所を指定します。

Type:	DriveType
Accepted values:	Automatic, A, 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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryPackageShareLocation

プライマリ パッケージ共有の場所を指定します。

Type:	DriveType
Accepted values:	Automatic, A, 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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimarySiteCode

親サイトの 3 文字のサイト コードを指定します。

Type:	String
Aliases:	ParentSiteCode
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryContentLibraryLocation

セカンダリ コンテンツ ライブラリの場所を指定します。

Type:	DriveType
Accepted values:	Automatic, A, 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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryPackageShareLocation

セカンダリ パッケージ共有の場所を指定します。

Type:	DriveType
Accepted values:	Automatic, A, 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
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondarySiteCode

セカンダリ サイトの一意の 3 文字のサイト コードを指定します。

Type:	String
Aliases:	SiteCode
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerName

セカンダリ サイト サーバーとして使用するサーバーの完全修飾ドメイン名 (FQDN) を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SiteName

セカンダリ サイトの識別に役立つサイト名を指定します。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SqlServerSetting

Configuration Manager の設定オブジェクトSQL Server配列を指定します。 このオブジェクトを取得するには 、New-CMSqlServerSetting コマンドレットを使用 します。

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ValidateContentSchedule

スケジュールの種類を表すオブジェクトを指定します。 Configuration Manager が配布ポイント上のパッケージの整合性を検証する頻度を決定します。 スケジュール トークン オブジェクトを作成するには 、New-CMSchedule コマンドレットを使用 します。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

なし

出力

IResultObject

IResultObject

IResultObject

IResultObject[]

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_SCI_SysResUse WMI クラス」を参照してください。

関連リンク

• New-CMInstallationSourceFile
• New-CMSqlServerSetting
• Remove-CMSecondarySite