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>]

Description

New-CMSecondarySite Cmdlet 會建立次要月臺。 如需詳細資訊，請 參閱準備安裝 Configuration Manager 月臺。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：建立次要月臺

第一個命令會建立 SQL Server 設定物件。 此物件指定將 SQL Server Express Microsoft複製到 Configuration Manager 次要月臺。 命令會將 物件儲存在 $CIObj 變數中。

第二個命令會建立名為 Contoso 遠端月臺的次要月臺，該月臺在名為 server2.corp.contoso.com 的伺服器上具有月臺碼 CM2。 命令會指定儲存在 $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
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowPreStaging

指出次要月臺是否可以預先設置內容。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-BoundaryGroup

為此月台系統指定界限群組對象的陣列。 若要取得此物件，請使用 Get-CMBoundaryGroup Cmdlet。

類型:	IResultObject[]
別名:	BoundaryGroups
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificateExpirationTimeUtc

指定次要站臺上發佈點的自我簽署憑證到期的日期和時間。

類型:	DateTime
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CertificatePassword

指定發佈點之 PKI 匯入憑證的密碼。

類型:	SecureString
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CertificatePath

指定發佈點所使用之 PKI 發行憑證的匯入路徑。 當次要月臺已安裝並設定 IIS 以建立發佈點時，就會套用此參數。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ClientConnectionType

指定客戶端連接類型。

類型:	ClientConnectionTypes
接受的值:	Intranet, Internet, InternetAndIntranet
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ContentMonitoringPriority

指定內容監視優先順序。

類型:	Priority
接受的值:	Lowest, Low, Medium, High, Highest
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CreateSelfSignedCertificate

表示次要月臺會建立發佈點的自我簽署憑證。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableAnonymous

指出客戶端電腦是否以匿名方式與發佈點通訊。 當次要月臺已安裝並設定 IIS 以建立發佈點時，就會套用此參數。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableBranchCache

指出允許使用 Windows BranchCache 的客戶端從內部部署發佈點下載內容。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWhenDuplicateCertificate

指出當您匯入次要月臺的 PKI 用戶端憑證時，Configuration Manager 是否會覆寫重複的憑證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Http

表示客戶端電腦使用 HTTP 與發布點通訊。 當次要月臺已安裝並設定 IIS 以建立發佈點時，就會套用此參數。 \

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Https

表示客戶端電腦使用 HTTPS 與發布點通訊。 當次要月臺已安裝並設定 IIS 以建立發佈點時，就會套用此參數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ImportCertificate

指出 Cmdlet 會匯入 PKI 憑證，而不是使用發佈點的自我簽署憑證。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InstallationFolder

指定 Cmdlet 安裝站臺檔案之次要月臺伺服器上的安裝資料夾。

類型:	String
別名:	InstallDir
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InstallationSourceFile

指定 Configuration Manager 安裝來源檔案物件的陣列。 若要取得此物件，請使用 New-CMInstallationSourceFile Cmdlet。

類型:	IResultObject[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-InstallInternetServer

指定是否要在 Configuration Manager 需要時安裝和設定 IIS。 此參數必須在 $True Cmdlet 為次要站臺上的發佈點安裝站台系統角色之前。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MinFreeSpaceMB

指定要在發佈點使用的每個磁碟驅動器上保留的空間量，以 MB 為單位。 這個值會決定磁碟驅動器上散發套件將內容儲存在磁碟驅動器之後的剩餘可用空間。

從 2107 版開始，預設的最小可用空間從 200 MB 變更為 500 MB。

類型:	Int32
Position:	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
Position:	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
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrimarySiteCode

指定父月臺的三個字元月臺碼。

類型:	String
別名:	ParentSiteCode
Position:	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
Position:	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
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SecondarySiteCode

為次要月臺指定唯一的三個字元月臺碼。

類型:	String
別名:	SiteCode
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ServerName

指定要作為次要月臺伺服器之伺服器的 FQDN) (完整功能變數名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SiteName

指定可協助識別次要月臺的月臺名稱。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-SqlServerSetting

指定 Configuration Manager 中 SQL Server 設定物件的陣列。 若要取得此物件，請使用 New-CMSqlServerSetting Cmdlet。

類型:	IResultObject[]
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ValidateContentSchedule

指定表示排程類型的物件。 它會決定 Configuration Manager 驗證發佈點上套件完整性的頻率。 若要建立排程令牌物件，請使用 New-CMSchedule Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

IResultObject

IResultObject

IResultObject

IResultObject[]

備註

如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_SCI_SysResUse伺服器 WMI 類別。

相關連結

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