New-CMSecondarySite
セカンダリ サイトを作成します。
構文
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 サイトをインストールするための準備」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: セカンダリ サイトを作成する
この最初のコマンドは、SQL Server 設定オブジェクトを作成します。 このオブジェクトは、Microsoft SQL Server Express が Configuration Manager セカンダリ サイトにコピーされることを指定します。 コマンドは、 オブジェクトを $CIObj 変数に格納します。
2 番目のコマンドは、 contoso リモート サイト という名前のセカンダリ サイトを作成し、サイト コード CM2 を server2.corp.contoso.com という名前のサーバーに作成します。 コマンドは、$CIObjに格納されているセカンダリ サイトの SQL Server 設定オブジェクトを指定します。 コマンドは、サイト コード 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
クライアントがコンテンツにフォールバック ソースの場所を使用できるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllowPreStaging
セカンダリ サイトがコンテンツを事前設定できるかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-BoundaryGroup
このサイト システムの境界グループ オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMBoundaryGroup コマンドレットを使用します。
| 型: | IResultObject[] |
| Aliases: | BoundaryGroups |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificateExpirationTimeUtc
セカンダリ サイトの配布ポイントに対して自己署名証明書の有効期限が切れる日時を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificatePassword
配布ポイントの PKI インポート証明書のパスワードを指定します。
| 型: | SecureString |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CertificatePath
配布ポイントが使用する PKI 発行証明書のインポート パスを指定します。 このパラメーターは、セカンダリ サイトが IIS をインストールし、配布ポイントを作成するように構成した場合に適用されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ClientConnectionType
クライアント接続の種類を指定します。
| 型: | ClientConnectionTypes |
| 指定可能な値: | Intranet, Internet, InternetAndIntranet |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ContentMonitoringPriority
コンテンツ監視の優先順位を指定します。
| 型: | Priority |
| 指定可能な値: | Lowest, Low, Medium, High, Highest |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CreateSelfSignedCertificate
セカンダリ サイトが配布ポイントの自己署名証明書を作成することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableAnonymous
クライアント コンピューターが配布ポイントと匿名で通信するかどうかを示します。 このパラメーターは、セカンダリ サイトが IIS をインストールし、配布ポイントを作成するように構成した場合に適用されます。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableBranchCache
Windows BranchCache を使用するクライアントが、オンプレミスの配布ポイントからコンテンツをダウンロードすることを許可されていることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWhenDuplicateCertificate
セカンダリ サイトの PKI クライアント証明書をインポートするときに、Configuration Manager が重複する証明書を上書きするかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Http
クライアント コンピューターが HTTP を使用して配布ポイントと通信することを示します。 このパラメーターは、セカンダリ サイトが IIS をインストールし、配布ポイントを作成するように構成した場合に適用されます。 \
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Https
クライアント コンピューターが HTTPS を使用して配布ポイントと通信することを示します。 このパラメーターは、セカンダリ サイトが IIS をインストールし、配布ポイントを作成するように構成した場合に適用されます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ImportCertificate
コマンドレットが配布ポイントに自己署名証明書を使用する代わりに PKI 証明書をインポートすることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallationFolder
コマンドレットがサイト ファイルをインストールするセカンダリ サイト サーバー上のインストール フォルダーを指定します。
| 型: | String |
| Aliases: | InstallDir |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallationSourceFile
Configuration Manager のインストール ソース ファイル オブジェクトの配列を指定します。 このオブジェクトを取得するには、 New-CMInstallationSourceFile コマンドレットを 使用します。
| 型: | IResultObject[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InstallInternetServer
Configuration Manager で必要な場合に IIS をインストールして構成するかどうかを指定します。
コマンドレットがセカンダリ サイトの配布ポイントのサイト システムの役割をインストールする前に、このパラメーターを $True する必要があります。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MinFreeSpaceMB
配布ポイントが使用する各ドライブに予約する領域の量をメガバイト単位で指定します。 この値は、ディストリビューションがドライブにコンテンツを格納した後のドライブの残りの空き領域を決定します。
バージョン 2107 以降では、既定の最小空き領域が 200 MB から 500 MB に変更されました。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrimaryContentLibraryLocation
プライマリ コンテンツ ライブラリの場所を指定します。
| 型: | DriveType |
| 指定可能な値: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrimaryPackageShareLocation
プライマリ パッケージ共有の場所を指定します。
| 型: | DriveType |
| 指定可能な値: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PrimarySiteCode
親サイトの 3 文字のサイト コードを指定します。
| 型: | String |
| Aliases: | ParentSiteCode |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondaryContentLibraryLocation
セカンダリ コンテンツ ライブラリの場所を指定します。
| 型: | DriveType |
| 指定可能な値: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondaryPackageShareLocation
セカンダリ パッケージ共有の場所を指定します。
| 型: | DriveType |
| 指定可能な値: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SecondarySiteCode
セカンダリ サイトの一意の 3 文字のサイト コードを指定します。
| 型: | String |
| Aliases: | SiteCode |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ServerName
セカンダリ サイト サーバーとして使用するサーバーの完全修飾ドメイン名 (FQDN) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SiteName
セカンダリ サイトを識別するのに役立つサイト名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SqlServerSetting
Configuration Manager で SQL Server 設定オブジェクトの配列を指定します。 このオブジェクトを取得するには、 New-CMSqlServerSetting コマンドレットを 使用します。
| 型: | IResultObject[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ValidateContentSchedule
スケジュールの種類を表すオブジェクトを指定します。 Configuration Manager が配布ポイント上のパッケージの整合性を検証する頻度を決定します。 スケジュール トークン オブジェクトを作成するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
IResultObject
IResultObject
IResultObject
IResultObject[]
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_SCI_SysResUse」を参照してください。