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

说明

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：升级共享分发点

第一个命令获取 ID 为 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

指定客户端连接类型。 有效值包含:

• Internet
• InternetAndIntranet
• Intranet

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-ContentValidationPriority

指定内容验证优先级。 有效值包含:

• 高
• Highest
• 低
• Lowest
• 中

默认值为“最低”。

类型:	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 Site Component Manager 服务使用站点系统安装帐户来安装、重新安装、卸载和配置站点系统。

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