共用方式為


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>]

Description

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

可讓站台系統在連線到因特網時使用 Proxy 伺服器。

類型: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。 系統會根據 DP 的月臺碼來篩選 MP,如果 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

指定發佈點用來連線到主要月臺資料庫的用戶名稱。 使用 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

備註

如需此傳回物件及其屬性的詳細資訊,請 參閱SMS_SCI_SysResUse伺服器 WMI 類別