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

注意

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

示例

示例 1:创建辅助站点

第一个命令创建 SQL Server 设置对象。 此对象指定Microsoft SQL Server Express 复制到 Configuration Manager 辅助站点。 命令将 对象存储在 $CIObj 变量中。

第二个命令创建名为 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
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 时是否安装和配置 IIS。 此参数必须在 $True cmdlet 为辅助站点上的分发点安装站点系统角色之前。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-MinFreeSpaceMB

指定要在分发点使用的每个驱动器上保留的空间量(以兆字节为单位)。 此值确定分发在驱动器上存储内容后驱动器上的剩余可用空间。

从版本 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 类