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 cmdlet 创建辅助站点。 有关详细信息，请参阅准备安装Configuration Manager站点。

注意

从Configuration Manager站点驱动器运行Configuration Manager cmdlet，例如 PS XYZ:\>。 有关详细信息，请参阅 入门。

示例

示例 1：创建辅助站点

第一个命令创建SQL Server settings 对象。 此对象指定将Microsoft SQL Server Express复制到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

指示客户端是否可以对内容使用回退源位置。

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 cmdlet。

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

提示你在运行 cmdlet 之前进行确认。

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

指示 cmdlet 导入 PKI 证书，而不是为分发点使用自签名证书。

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

-InstallationFolder

指定辅助站点服务器上的安装文件夹，cmdlet 在其中安装站点文件。

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

-InstallationSourceFile

指定Configuration Manager的安装源文件对象的数组。 若要获取此对象，请使用 New-CMInstallationSourceFile cmdlet。

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

-InstallInternetServer

指定在Configuration Manager需要 IIS 时是否安装和配置 IIS。 此参数必须在 $True cmdlet 为辅助站点上的分发点安装站点系统角色之前。

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

指定父站点的三个字符的网站代码。

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

为辅助站点指定唯一的三个字符的站点代码。

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 cmdlet。

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

-ValidateContentSchedule

指定表示计划类型的 对象。 它确定Configuration Manager验证分发点上包完整性的频率。 若要创建计划令牌对象，请使用 New-CMSchedule cmdlet。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

None

输出

IResultObject

IResultObject

IResultObject

IResultObject[]

备注

有关此返回对象及其属性的详细信息，请参阅 SMS_SCI_SysResUse服务器 WMI 类。

相关链接

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