Add-CMDistributionPoint

添加分发点角色。

语法

Add-CMDistributionPoint
   [-AllowFallbackForContent]
   [-AllowPreStaging]
   [-AllowProxyTraffic]
   [-AllowPxeResponse]
   -CertificateExpirationTimeUtc <DateTime>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous]
   [-EnableBranchCache]
   [-EnableContentValidation]
   [-EnableLedbat]
   [-EnableMulticast]
   [-EnableNonWdsPxe]
   [-EnablePullDP]
   [-EnablePxe]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableSsl]
   [-EnableUnknownComputerSupport]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   -InputObject <IResultObject>
   [-InstallInternetServer]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumFreeSpaceMB <Int32>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   [-SessionStartDelayMins <Int32>]
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDistributionPoint
   [-AllowFallbackForContent]
   [-AllowPreStaging]
   [-AllowProxyTraffic]
   [-AllowPxeResponse]
   -CertificateExpirationTimeUtc <DateTime>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous]
   [-EnableBranchCache]
   [-EnableContentValidation]
   [-EnableLedbat]
   [-EnableMulticast]
   [-EnableNonWdsPxe]
   [-EnablePullDP]
   [-EnablePxe]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableSsl]
   [-EnableUnknownComputerSupport]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   [-InstallInternetServer]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumFreeSpaceMB <Int32>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   [-SessionStartDelayMins <Int32>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDistributionPoint
   [-AllowFallbackForContent]
   [-AllowPreStaging]
   [-AllowProxyTraffic]
   [-AllowPxeResponse]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous]
   [-EnableBranchCache]
   [-EnableContentValidation]
   [-EnableLedbat]
   [-EnableMulticast]
   [-EnableNonWdsPxe]
   [-EnablePullDP]
   [-EnablePxe]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableSsl]
   [-EnableUnknownComputerSupport]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   [-InstallInternetServer]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumFreeSpaceMB <Int32>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   [-SessionStartDelayMins <Int32>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMDistributionPoint
   [-AllowFallbackForContent]
   [-AllowPreStaging]
   [-AllowProxyTraffic]
   [-AllowPxeResponse]
   -CertificatePassword <SecureString>
   -CertificatePath <String>
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous]
   [-EnableBranchCache]
   [-EnableContentValidation]
   [-EnableLedbat]
   [-EnableMulticast]
   [-EnableNonWdsPxe]
   [-EnablePullDP]
   [-EnablePxe]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableSsl]
   [-EnableUnknownComputerSupport]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   -InputObject <IResultObject>
   [-InstallInternetServer]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumFreeSpaceMB <Int32>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PrimaryContentLibraryLocation <DriveType>]
   [-PrimaryPackageShareLocation <DriveType>]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-SecondaryContentLibraryLocation <DriveType>]
   [-SecondaryPackageShareLocation <DriveType>]
   [-SessionStartDelayMins <Int32>]
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Add-CMDistributionPoint cmdlet 在站点系统服务器上创建分发点。 分发点是一个站点系统角色,Configuration Manager 使用该角色来存储供客户端下载的文件。 存储应用程序内容、软件包、软件更新、操作系统映像和启动映像等文件。

在向客户端计算机提供内容之前,请将站点系统服务器分配为分发点。 可以将分发点站点角色添加到新的站点系统服务器,或将站点角色添加到现有站点系统服务器。

注意

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

示例

示例 1:使用站点系统服务器对象添加站点

第一个命令创建自当前日期起 30 年的日期对象,并将对象存储在 $Date 变量中。

第二个命令获取名为 MySiteSys_11310.Contoso.com 的站点系统服务器对象,并将 对象存储在 $SystemServer 变量中。

第三个命令将分发点添加到存储在 $SystemServer 中的站点系统服务器,并将证书过期日期设置为 存储在 $Date 中的日期。

$Date = [DateTime]::Now.AddYears(30)
$SystemServer = Get-CMSiteSystemServer -SiteSystemServerName "MySiteSys_11310.Contoso.com"
Add-CMDistributionPoint -InputObject $SystemServer -CertificateExpirationTimeUtc $Date

示例 2:使用管道添加站点

第一个命令创建自当前日期起 30 年的日期对象,并将对象存储在 $Date 变量中。

第二个命令获取名为 MySiteSys_11310.Contoso.com 的站点系统服务器对象。 然后,它使用管道运算符将 对象传递给 Add-DistributionPoint,后者将分发点添加到站点系统服务器对象。 然后,它将证书过期时间设置为 存储在 $Date 中的日期。

$Date = [DateTime]::Now.AddYears(30)
Get-CMSiteSystemServer -SiteSystemServerName "MySiteSys_11310.Contoso.com" | Add-CMDistributionPoint -CertificateExpirationTimeUtc $Date

参数

-AllowFallbackForContent

指示与站点系统关联的边界组之外的客户端可以回退。 如果没有其他站点系统可用,这些客户端可以将此站点系统用作内容的源位置。

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

-AllowPreStaging

指示分发点可以预留内容。

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

-AllowProxyTraffic

允许站点系统在连接到 Internet 时使用代理服务器。

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

-AllowPxeResponse

指示分发点可以响应 PXE 请求。

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

-CertificateExpirationTimeUtc

以 UTC 格式指定证书过期的日期和时间。

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

-CertificatePassword

指定 PKI 客户端证书的密码作为安全字符串。

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

-CertificatePath

指定 PKI 客户端证书的导入路径。

类型: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

-ContentValidationSchedule

指定分发点用于按计划验证内容的计划令牌对象。 若要创建计划令牌对象,请使用 New-CMSchedule cmdlet。

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

-Description

指定分发点的说明。

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

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-EnableAnonymous

指示分发点允许从 Configuration Manager 客户端到内容库的匿名连接。

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

-EnableBranchCache

指示允许使用 Windows BranchCache 的客户端从本地分发点下载内容。 从基于云的分发点下载的内容始终可以由使用 Windows BranchCache 的客户端共享。

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

-EnableContentValidation

指示为此分发点启用了内容验证。

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

-EnableLedbat

通过 Windows LEDBAT 启用分发点以使用网络拥塞控制。 此功能可以调整下载速度以使用未使用的网络带宽。

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

-EnableMulticast

指示为此分发点启用了多播。

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

-EnableNonWdsPxe

指示是否在分发点上启用了 Configuration Manager PXE 响应程序。 在没有 Windows 部署服务 (WDS) 的情况下启用 PXE 响应程序时,Configuration Manager 会在分发点上安装其 PXE 响应程序服务。

有关详细信息,请参阅 在分发点上启用 PXE

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

-EnablePullDP

设置为 $True时,分发点能够从其他分发点拉取内容。

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

-EnablePxe

指示在分发点上启用了 PXE。

启用 PXE 时,Configuration Manager 会在服务器上安装 Windows 部署服务(如有必要)。 Windows 部署服务是执行 PXE 启动以安装操作系统的服务。 创建分发点后,Configuration Manager 会在 Windows 部署服务中安装使用 PXE 启动函数的提供程序。

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

-EnableScheduledMulticast

指示是否可以计划 Configuration Manager 何时从分发点部署操作系统映像。

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

-EnableSsl

指示在此分发点上启用了 SSL。

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

-EnableUnknownComputerSupport

指示已启用对未知计算机的支持。 未知计算机不是由 Configuration Manager 管理的计算机。

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

-EndIPAddress

指定 Configuration Manager 用于将数据发送到客户端的多播地址范围内的结束 IP 地址。

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

-EndUdpPort

指定 Configuration Manager 用于将数据发送到客户端的多播 UDP 端口范围内的结束 UDP 端口。

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

-Force

使用此参数可以添加重复的证书,而无需请求确认。

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

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-InitialMPForLookup

它 (是必需的,在提供 -PreferredMPEnabled 参数时需要) 。 它需要一个字符串输入,表示由 * 符号分隔的不同查找 MP。 MP 根据 DP 的站点代码进行筛选,如果 MP 的站点代码不同,则会引发错误。

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

-InputObject

指定要添加分发点角色的站点系统服务器对象。 若要获取此对象,请使用 Get-CMSiteSystemServer cmdlet。

类型:IResultObject
别名:SiteServer
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-InstallInternetServer

指示 Configuration Manager 在服务器上安装并配置 Internet Information Services (IIS) (如果尚未安装)。 分发点角色需要 IIS。

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

-MacAddressForRespondingPxeRequest

指定分发点用于响应 PXE 请求的 MAC 地址数组。

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

-MinimumFreeSpaceMB

指定要在此分发点使用的每个驱动器上保留的可用空间量。 达到此限制时,Configuration Manager 会选择其他驱动器,并继续向该驱动器复制过程。 内容文件可以跨多个驱动器。

从版本 2107 开始,默认最小可用空间从 50 MB 更改为 500 MB

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

-MinimumSessionSize

指定在计划的多播开始部署操作系统之前必须接收多少个客户端请求。

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

-MulticastMaximumClientCount

指定可从此分发点下载操作系统的最大客户端数。

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

-PreferredMPEnabled

它是 switch 参数。 参数的存在指示已启用动态 MP 用法。 在使用此参数之前,必须在分发点上启用 PXE。

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

-PrimaryContentLibraryLocation

指定主要内容位置。 Configuration Manager 会将内容复制到主要内容位置,直到可用空间量达到为 MinimumFreeSpaceMB 参数指定的值。

类型: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

指定主包共享位置。 Configuration Manager 会将内容复制到主包共享位置,直到可用空间量达到为 MinimumFreeSpaceMB 参数指定的值。

类型: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

-PxePassword

指定 PXE 密码作为安全字符串。

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

-PxeServerResponseDelaySec

指定在使用多个启用了 PXE 的分发点时,分发点在响应计算机请求之前延迟的时间(以秒为单位)。 默认情况下,Configuration Manager PXE 服务点首先响应网络 PXE 请求。

类型:Int32
别名:PxeServerResponseDelaySeconds
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

-SessionStartDelayMins

指定 Configuration Manager 在响应第一个部署请求之前等待的分钟数。

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

-SiteCode

指定承载此站点系统角色的站点的三个字符代码。

从版本 2111 开始,无法为此参数指定管理中心站点 (CAS) ,该参数不支持任何面向客户端的站点系统角色。

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

-SiteSystemServerName

指定要托管站点系统角色的服务器的名称。

类型:String
别名:Name, ServerName
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SourceDistributionPoint

指定此分发点可以从中拉取内容的分发点源数组。

类型:String[]
别名:SourceDistributionPoints
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SourceDPRank

指定一个数组,其中包含此分发点可以从中拉取内容的分发点源的优先级。 将随机选择优先级相同的源分发点。

类型:Int32[]
别名:SourceDPRanks
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-StartIPAddress

指定 Configuration Manager 用于将数据发送到客户端的多播地址范围内的起始 IP 地址。

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

-StartUdpPort

指定 Configuration Manager 用于将数据发送到客户端的多播 UDP 端口范围内的起始 UDP 端口。

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

-UserDeviceAffinity

指定希望分发点如何将用户与其设备关联,以便进行 PXE 部署。

类型:UserDeviceAffinityType
接受的值:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UserName

指定分发点用于连接到主站点数据库的用户的名称。 使用“域\用户名”格式。

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

-WhatIf

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

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

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