Start-CMDistributionPointUpgrade

模組:

ConfigurationManager

升級共用發佈點。

語法

Start-CMDistributionPointUpgrade
     [-AllowFallbackForContent <Boolean>]
     [-AllowPreStaging <Boolean>]
     [-AllowRespondIncomingPxeRequest <Boolean>]
     [-CertificatePassword <SecureString>]
     -CertificatePath <String>
     [-ClientCommunicationMode <ComputerCommunicationType>]
     [-ClientConnectionType <ClientConnectionTypes>]
     [-ContentValidationPriority <Priority>]
     -DestinationSiteCode <String>
     [-EnableAnonymous <Boolean>]
     [-EnableNonWdsPxe <Boolean>]
     [-EnablePxeSupport <Boolean>]
     [-EnableUnknownComputerSupport <Boolean>]
     [-ForceWhenDuplicateCertificate <Boolean>]
     [-InitiateConnection <Boolean>]
     -InputObject <IResultObject>
     [-InstallationAccount <IResultObject>]
     [-InstallIis <Boolean>]
     [-MacAddressForRespondingPxeRequest <String[]>]
     [-MinFreeSpaceMB <Int32>]
     [-PathForSavingMigratedPackage <String>]
     [-PrimaryContentLibraryLocation <DriveType>]
     [-PrimaryPackageShareLocation <DriveType>]
     [-PublicFqdn <String>]
     [-PxePassword <SecureString>]
     [-PxeServerResponseDelaySec <Int32>]
     [-SecondaryContentLibraryLocation <DriveType>]
     [-SecondaryPackageShareLocation <DriveType>]
     [-UserDeviceAffinity <UserDeviceAffinityType>]
     [-ValidateContentSchedule <IResultObject>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMDistributionPointUpgrade
     [-AllowFallbackForContent <Boolean>]
     [-AllowPreStaging <Boolean>]
     [-AllowRespondIncomingPxeRequest <Boolean>]
     -CertificateExpirationTimeUtc <DateTime>
     [-ClientCommunicationMode <ComputerCommunicationType>]
     [-ClientConnectionType <ClientConnectionTypes>]
     [-ContentValidationPriority <Priority>]
     -DestinationSiteCode <String>
     [-EnableAnonymous <Boolean>]
     [-EnableNonWdsPxe <Boolean>]
     [-EnablePxeSupport <Boolean>]
     [-EnableUnknownComputerSupport <Boolean>]
     [-InitiateConnection <Boolean>]
     -InputObject <IResultObject>
     [-InstallationAccount <IResultObject>]
     [-InstallIis <Boolean>]
     [-MacAddressForRespondingPxeRequest <String[]>]
     [-MinFreeSpaceMB <Int32>]
     [-PathForSavingMigratedPackage <String>]
     [-PrimaryContentLibraryLocation <DriveType>]
     [-PrimaryPackageShareLocation <DriveType>]
     [-PublicFqdn <String>]
     [-PxePassword <SecureString>]
     [-PxeServerResponseDelaySec <Int32>]
     [-SecondaryContentLibraryLocation <DriveType>]
     [-SecondaryPackageShareLocation <DriveType>]
     [-UserDeviceAffinity <UserDeviceAffinityType>]
     [-ValidateContentSchedule <IResultObject>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Start-CMDistributionPointUpgrade Cmdlet 會將共用發佈點升級至 Configuration Manager 發佈點。

從 Configuration Manager 2007 來源階層移轉時，您可以升級共用發佈點，使其成為 Configuration Manager 發佈點。 您可以升級主要月臺和次要月臺的發佈點。 升級程式會從 Configuration Manager 2007 階層移除發佈點，並使它成為 Configuration Manager 階層中的站台系統伺服器。 此程式也會將發佈點上的現有內容複製到發佈點計算機上的新位置。 升級程式接著會修改內容複本，以建立 Configuration Manager 單一實例存放區，以搭配 Configuration Manager 內容部署使用。 因此，當您升級發佈點時，不需要重新發佈裝載於 Configuration Manager 2007 發佈點上的移轉內容。

注意事項

從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：升級共用發佈點

第一個命令會取得標識符為 6617708D-0F98-4898-8D05-9E882C23DCB2 的發佈點物件，並將對象儲存在$CIObj變數中。

第二個命令會將儲存在 $CIObj 中的共用發佈點升級至具有月臺碼 CM1 的 Configuration Manager 月臺。 命令會指定發佈點所使用之 PKI 發行憑證的匯入路徑，並指定發佈點可以預先暫存內容。

$CIObj = Get-CMDistributionPoint -DistributionPointGroupId "{6617708D-0F98-4898-8D05-9E882C23DCB2}"
Start-CMDistributionPointUpgrade -AllowPreStaging $True -CertificatePath "\\Contoso01\CM\Toolbox\BaseCert.txt" -SharedDistributionPoint $CIObj -SiteCode "CM1"

參數

-AllowFallbackForContent

指出用戶端是否可以使用內容的後援來源位置。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowPreStaging

指出發佈點是否可以預先暫存內容。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AllowRespondIncomingPxeRequest

指出發佈點是否可以回應 PXE) 要求 (開機前執行環境。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificateExpirationTimeUtc

指定憑證到期的日期和時間。

類型:	DateTime
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-CertificatePassword

為發佈點的 PKI) 客戶端憑證 (公鑰基礎結構指定密碼做為安全字串。

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CertificatePath

指定發佈點所使用之 PKI 發行憑證的匯入路徑。

類型:	String
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ClientCommunicationMode

類型:	ComputerCommunicationType
接受的值:	Http, Https
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClientConnectionType

指定客戶端連接類型。 有效值為：

• 網際網路
• InternetAndIntranet
• 內部網路

類型:	ClientConnectionTypes
接受的值:	Intranet, Internet, InternetAndIntranet
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ContentValidationPriority

指定內容驗證優先順序。 有效值為：

• 高
• 最高
• 低
• 最低
• 中

默認值為 [最低]。

類型:	Priority
接受的值:	Lowest, Low, Medium, High, Highest
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DestinationSiteCode

類型:	String
別名:	SiteCode
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DisableWildcardHandling

此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableAnonymous

指出發佈點是否允許從 Configuration Manager 用戶端到內容庫的匿名連線。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableNonWdsPxe

指出是否已在發佈點上啟用 Configuration Manager PXE 回應程式。 當您在沒有 Windows 部署服務 (WDS) 的情況下啟用 PXE 回應程式時，Configuration Manager 會在發佈點上安裝其 PXE 回應程式服務。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnablePxeSupport

指出是否要在發佈點上啟用 PXE。

當您啟用 PXE 時，Configuration Manager 會視需要在伺服器上安裝 Windows 部署服務。 Windows 部署服務是執行 PXE 開機以安裝作業系統的服務。 建立發佈點之後，Configuration Manager 會在 Windows 部署服務中安裝使用 PXE 開機函式的提供者。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableUnknownComputerSupport

指出是否啟用未知計算機的支援。 未知的電腦不是由 Configuration Manager 管理的電腦。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWhenDuplicateCertificate

指出當您匯入發佈點的 PKI 用戶端憑證時，Configuration Manager 是否會覆寫重複的憑證。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ForceWildcardHandling

此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InitiateConnection

指出發佈點是否起始與客戶端的連線。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InputObject

類型:	IResultObject
別名:	SharedDistributionPoint
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-InstallationAccount

指定站臺系統安裝帳戶。 Configuration Manager 2007 月臺元件管理員服務會使用月台系統安裝帳戶來安裝、重新安裝、卸載及設定月台系統。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-InstallIis

類型:	Boolean
別名:	InstallInternetServer
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MacAddressForRespondingPxeRequest

指定發佈點用來回應開機前執行環境的媒體訪問控制器數位 (MAC) 位址， (PXE) 要求。

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MinFreeSpaceMB

在 Configuration Manager 選擇不同的磁碟驅動器並繼續將複製程式複製到該磁碟驅動器之前，指定磁碟驅動器上的可用空間量。 內容檔案可以跨越多個磁碟驅動器。

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PathForSavingMigratedPackage

指定已移轉內容複本的路徑。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PrimaryContentLibraryLocation

指定主要內容位置。 Configuration Manager 會將內容複製到主要內容位置，直到可用空間量達到您為 MinFreeSpaceMB 參數指定的值為止。 有效值為：

• 自動。
• 從 A：到 Z：的驅動器號。

類型:	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 會將內容複製到主要套件共用位置，直到可用空間量達到您為 MinFreeSpaceMB 參數指定的值為止。 有效值為：

• 自動。
• 從 A：到 Z：的驅動器號。

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

-PublicFqdn

指定裝載發佈點之月台系統伺服器的完整功能變數名稱 (FQDN) 。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PxePassword

類型:	SecureString
別名:	ComputersUsePxePassword
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PxeServerResponseDelaySec

類型:	Int32
別名:	PxeServerResponseDelaySeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-SecondaryContentLibraryLocation

指定次要內容位置。 有效值為：

• 自動。
• 從 A：到 Z：的驅動器號。

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

指定次要套件共用位置。 有效值為：

• 自動。
• 從 A：到 Z：的驅動器號。

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

-UserDeviceAffinity

指定發佈點如何將使用者與 PXE 部署的目的地計算機產生關聯。 有效值為：

• AllowWithAutomaticApproval
• AllowWithManualApproval
• DoNotUse

類型:	UserDeviceAffinityType
接受的值:	DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ValidateContentSchedule

指定 CMSchedule 物件。 CMSchedule 物件會定義驗證發佈點上內容檔案完整性的排程。 若要建立 CMSchedule 物件，請使用 New-CMSchedule Cmdlet。

類型:	IResultObject
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	False
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

相關連結

• Get-CMDistributionPointGroup
• Get-CMBoundaryGroup
• Get-CMDistributionPoint
• New-CMSchedule