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

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

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

-AllowPreStaging

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

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

-AllowProxyTraffic

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

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

-AllowPxeResponse

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

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

-CertificateExpirationTimeUtc

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

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 客户端证书的导入路径。

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

-ContentValidationSchedule

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

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

-Description

指定分发点的说明。

Type:String
Position:Named
Default value:None
Required:False
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

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

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

-EnableBranchCache

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

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

-EnableContentValidation

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

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

-EnableLedbat

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

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

-EnableMulticast

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

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

-EnableNonWdsPxe

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

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

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

-EnablePullDP

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

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

-EnablePxe

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

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

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

-EnableScheduledMulticast

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

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

-EnableSsl

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

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

-EnableUnknownComputerSupport

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

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

-EndIPAddress

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

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

-EndUdpPort

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

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

-Force

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

Type:SwitchParameter
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

-InitialMPForLookup

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

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

-InputObject

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

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

-InstallInternetServer

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

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

-MacAddressForRespondingPxeRequest

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

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

-MinimumFreeSpaceMB

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

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

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

-MinimumSessionSize

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

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

-MulticastMaximumClientCount

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

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

-PreferredMPEnabled

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

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

-PrimaryContentLibraryLocation

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

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

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

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

-PxePassword

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

Type:SecureString
Aliases:ComputersUsePxePassword
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PxeServerResponseDelaySec

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

Type:Int32
Aliases:PxeServerResponseDelaySeconds
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

-SessionStartDelayMins

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

Type:Int32
Aliases:SessionStartDelayMinutes
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SiteCode

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

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

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

-SiteSystemServerName

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

Type:String
Aliases:Name, ServerName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceDistributionPoint

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

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

-SourceDPRank

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

Type:Int32[]
Aliases:SourceDPRanks
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartIPAddress

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

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

-StartUdpPort

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

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

-UserDeviceAffinity

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

Type:UserDeviceAffinityType
Accepted values:DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserName

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

Type:String
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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject

备注

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