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