Set-CMDistributionPoint

配置分发点。

语法

Set-CMDistributionPoint
   [-EnableMaintenanceMode <Boolean>]
   [-AddBoundaryGroupName <String[]>]
   [-AddMacAddressForRespondingPxeRequest <String[]>]
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-AllowProxyTraffic <Boolean>]
   [-AllowPxeResponse <Boolean>]
   [-CertificateExpirationTimeUtc <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-ClearMacAddressForRespondingPxeRequest]
   [-ClientCommunicationType <ComputerCommunicationType>]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ClientTransferRate <NetworkProfile>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache <Boolean>]
   [-EnableContentValidation <Boolean>]
   [-EnableLedbat <Boolean>]
   [-EnableMulticast <Boolean>]
   [-EnableNonWdsPxe <Boolean>]
   [-EnablePullDP <Boolean>]
   [-EnablePxe <Boolean>]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableUnknownComputerSupport <Boolean>]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   [-InputObject] <IResultObject>
   [-KeepWds <Boolean>]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PassThru]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-ReassignSiteCode <String>]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveMacAddressForRespondingPxeRequest <String[]>]
   [-RespondToAllNetwork]
   [-SessionStartDelayMins <Int32>]
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UseAnyRangeIP]
   [-UseComputerAccount]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-EnableDoinc <Boolean>]
   [-DiskSpaceUnit <DiskSpaceEnum>]
   [-DiskSpaceDoinc <Int32>]
   [-LocalDriveDoinc <String>]
   [-RetainDoincCache <Boolean>]
   [-AgreeDoincLicense <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDistributionPoint
   [-EnableMaintenanceMode <Boolean>]
   [-AddBoundaryGroupName <String[]>]
   [-AddMacAddressForRespondingPxeRequest <String[]>]
   [-AllowFallbackForContent <Boolean>]
   [-AllowPreStaging <Boolean>]
   [-AllowProxyTraffic <Boolean>]
   [-AllowPxeResponse <Boolean>]
   [-CertificateExpirationTimeUtc <DateTime>]
   [-CertificatePassword <SecureString>]
   [-CertificatePath <String>]
   [-ClearMacAddressForRespondingPxeRequest]
   [-ClientCommunicationType <ComputerCommunicationType>]
   [-ClientConnectionType <ClientConnectionTypes>]
   [-ClientTransferRate <NetworkProfile>]
   [-ContentMonitoringPriority <Priority>]
   [-ContentValidationSchedule <IResultObject>]
   [-Description <String>]
   [-EnableAnonymous <Boolean>]
   [-EnableBranchCache <Boolean>]
   [-EnableContentValidation <Boolean>]
   [-EnableLedbat <Boolean>]
   [-EnableMulticast <Boolean>]
   [-EnableNonWdsPxe <Boolean>]
   [-EnablePullDP <Boolean>]
   [-EnablePxe <Boolean>]
   [-EnableScheduledMulticast <Boolean>]
   [-EnableUnknownComputerSupport <Boolean>]
   [-EndIPAddress <String>]
   [-EndUdpPort <Int32>]
   [-Force]
   [-KeepWds <Boolean>]
   [-MacAddressForRespondingPxeRequest <String[]>]
   [-MinimumSessionSize <Int32>]
   [-MulticastMaximumClientCount <Int32>]
   [-PassThru]
   [-PxePassword <SecureString>]
   [-PxeServerResponseDelaySec <Int32>]
   [-ReassignSiteCode <String>]
   [-RemoveBoundaryGroupName <String[]>]
   [-RemoveMacAddressForRespondingPxeRequest <String[]>]
   [-RespondToAllNetwork]
   [-SessionStartDelayMins <Int32>]
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   [-SourceDistributionPoint <String[]>]
   [-SourceDPRank <Int32[]>]
   [-StartIPAddress <String>]
   [-StartUdpPort <Int32>]
   [-UseAnyRangeIP]
   [-UseComputerAccount]
   [-UserDeviceAffinity <UserDeviceAffinityType>]
   [-UserName <String>]
   [-EnableDoinc <Boolean>]
   [-DiskSpaceUnit <DiskSpaceEnum>]
   [-DiskSpaceDoinc <Int32>]
   [-LocalDriveDoinc <String>]
   [-RetainDoincCache <Boolean>]
   [-AgreeDoincLicense <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Set-CMDistributionPoint cmdlet 修改站点系统服务器上的分发点。

注意

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

示例

示例 1:设置分发点的属性

第一个命令获取名为 MySiteSys_11310.Contoso.com 的站点系统服务器的分发点对象。 然后,它将 对象存储在 $DP 变量中。 第二个命令修改存储在该变量中的分发点对象。

$DP = Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com"
Set-CMDistributionPoint -InputObject $DP -AllowFallbackForContent $True -AllowPreStaging $True -AllowPxeResponse $False -ClientCommunicationType Http -ClientConnectionType Internet -ContentMonitoringPriority High

示例 2:将分发点重新分配到新站点

以下示例将 mydp 服务器从站点 ABC 重新分配到站点 XYZ

Set-CMDistributionPoint -SiteSystemServerName "MyDP.TestDOM.net" -SiteCode "ABC" -ReassignSiteCode "XYZ"

示例 3:启用Microsoft连接的缓存

第一个命令获取分发点对象,并将其存储在变量中。 它通过管道传递该对象,以启用连接缓存并配置其他相关设置。

$dp = Get-CMDistributionPoint -SiteSystemServerName "dp01.contoso.com"

$dp | Set-CMDistributionPoint -RetainDoincCache $true -EnableDoinc $true -AgreeDoincLicense $true

$dp | Set-CMDistributionPoint -LocalDriveDoinc "Z:" -DiskSpaceDoinc 9000 -DiskSpaceUnit GB

参数

-AddBoundaryGroupName

按名称将边界组数组添加到分发点。

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

-AddMacAddressForRespondingPxeRequest

添加一个 MAC 地址数组,用于响应已启用 PXE 的分发点的 PXE 请求。

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

-AgreeDoincLicense

使用 EnableDoinc 参数时,请将此参数 $true 设置为 以接受Microsoft连接的缓存服务器许可条款。 有关详细信息,请参阅 Configuration Manager 中的 Microsoft 联网缓存

如果已同意许可条款,则无需包含此参数。 当不必要地包含此警告时,会看到此警告:The parameter 'AgreeDoincLicense' has been ignored. Reason: Once the license terms agreement is selected, it will be grayed out and never uncheck it.

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

-AllowFallbackForContent

指示当其他站点系统不可用时,与站点系统关联的边界组外部的客户端是否可以回退并使用此站点系统作为内容的源位置。

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

-AllowPreStaging

指示是否为预留内容启用分发点。

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

-AllowProxyTraffic

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

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

-AllowPxeResponse

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

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

-CertificateExpirationTimeUtc

指定自签名证书过期的日期和时间。

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

-CertificatePassword

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

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

-CertificatePath

指定要为 HTTPS 通信导入的 PKI 客户端证书的路径。 将 CertificatePassword 参数用于证书的密码。

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

-ClearMacAddressForRespondingPxeRequest

添加此参数可删除分发点用于响应 PXE 请求的 MAC 地址数组。

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

-ClientCommunicationType

指定客户端或设备与分发点的通信方式。 如果指定 Https,请使用 CertificatePathCertificatePassword 参数来指定要使用的 PKI 证书。

类型:ComputerCommunicationType
接受的值:Http, Https
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClientConnectionType

指定客户端连接类型。

类型:ClientConnectionTypes
接受的值:Intranet, Internet, InternetAndIntranet
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClientTransferRate

指定客户端传输速率。

类型:NetworkProfile
接受的值:None, ProfileCustom, Profile10Mbps, Profile100Mbps, Profile1Gbps
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

如果使用 EnableContentValidation 参数,请使用此参数指定分发点验证内容时的计划。 若要创建计划令牌对象,请使用 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

-DiskSpaceDoinc

使用 EnableDoinc 参数时,请使用此参数指定要用于Microsoft连接缓存的磁盘空间量。 使用 DiskSpaceUnit 参数确定此值是磁盘空间(以 GB 为单位)还是百分比值。

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

-DiskSpaceUnit

将此参数与 DiskSpaceDoinc 一起使用,以确定该值是磁盘空间(以 GB 为单位)还是百分比值。

类型:DiskSpaceEnum
接受的值:GB, Percentage
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableAnonymous

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

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

-EnableBranchCache

指示允许使用 Windows BranchCache 的客户端从此本地分发点下载内容。

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

-EnableContentValidation

指示为此分发点启用了内容验证。 使用 ContentValidationSchedule 参数指定计划。

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

-EnableDoinc

将此参数设置为 , $true 使此分发点可用作Microsoft连接的缓存服务器。 有关详细信息,请参阅 Configuration Manager 中的 Microsoft 联网缓存

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

-EnableLedbat

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

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

-EnableMaintenanceMode

将此参数设置为 $true 以启用 维护模式

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

-EnableMulticast

为分发点启用多播。

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

-EnableNonWdsPxe

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

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

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

-EnablePullDP

设置为 $True时,分发点可以从其他分发点拉取内容。 将此参数与 SourceDPRankSourceDistributionPoint 参数一起使用。

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

-EnablePxe

在分发点上启用 PXE。 启用 PXE 时,Configuration Manager 会在服务器上安装 Windows 部署服务 (WDS) (如果尚未安装)。 WDS 是支持 PXE 启动以通过网络安装 Windows 映像的服务。

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

-EnableScheduledMulticast

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

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

-EnableUnknownComputerSupport

启用对未知计算机的支持。 未知计算机是 Configuration Manager 尚未发现的设备。

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

此参数需要一个字符串,该字符串表示由符号 *分隔的不同查找 MP。 根据 DP 的站点代码筛选掉 MP,如果 MP 的站点代码不同,则会引发错误。

  • 如果 DP 已启用首选 MP,则 -InitialMPForLookup 接受 MP 字符串。
  • 如果将 PreferredMPEnabled 设置为 disabled,则不需要传入 -InitialMPForLookup。
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

指定要配置的分发点对象。 若要获取此对象,请使用 Get-CMDistributionPoint cmdlet。

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

-KeepWds

指示分发点是将 Windows 部署服务 (WDS) ,还是在禁用 PXE 时将其删除。

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

-LocalDriveDoinc

使用 EnableDoinc 参数时,请使用此参数选择要用于Microsoft连接缓存的驱动器。 如果指定 Automatic,则 Configuration Manager 会选择可用空间最多的驱动器。

类型:String
接受的值: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

-MacAddressForRespondingPxeRequest

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

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

-MinimumSessionSize

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

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

-MulticastMaximumClientCount

指定可从此分发点下载 OS 的最大客户端数。

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

-PassThru

返回一个 对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。

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

-PreferredMPEnabled

此参数是布尔值,其中参数的$true值指示已启用动态 MP 用法。 在使用此参数之前,必须在分发点上启用 PXE。

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

-ReassignSiteCode

使用此参数将分发点重新分配到新站点。 将三个字母的网站代码指定为字符串值。

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

-RemoveBoundaryGroupName

从分发点中删除按名称列出的边界组数组。

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

-RemoveMacAddressForRespondingPxeRequest

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

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

-RespondToAllNetwork

指示分发点响应到达其任何网络接口的 PXE 请求。

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

-RetainDoincCache

使用 EnableDoinc 参数时,禁用Microsoft连接缓存时,请使用此参数将内容保留在服务器上。

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

-SessionStartDelayMins

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

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

-SiteCode

指定托管此站点系统角色的 Configuration Manager 站点的三个字符代码。

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

-SiteSystemServerName

指定承载此站点系统角色的服务器的 FQDN。

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

-SourceDistributionPoint

使用 EnablePullDP 参数时,请使用此参数指定分发点源的数组。 此分发点从指定的源拉取内容。 使用 SourceDPRank 参数确定这些源的优先级。

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

-SourceDPRank

指定一个数组,该数组包含此分发点可以从中拉取内容的分发点源的优先级。 当源分发点具有相同的优先级时,拉取分发点会随机选择一个源。 将此参数与 EnablePullDPSourceDistributionPoint 参数一起使用。

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

-UseAnyRangeIP

指示多播使用任何范围内的 IP 地址。

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

-UseComputerAccount

指示分发点在连接到主站点数据库时将其计算机帐户用作多播连接帐户。

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

-UserDeviceAffinity

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

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

-UserName

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

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

-WhatIf

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

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

IResultObject