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