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

指示客户端是否可以对内容使用回退源位置。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPreStaging

指示分发点是否可以预先暂存内容。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowRespondIncomingPxeRequest

指示分发点是否可以响应预启动执行环境 (PXE) 请求。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateExpirationTimeUtc

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

Type:	DateTime
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePassword

将公钥基础结构的密码指定为安全字符串， (分发点的 PKI) 客户端证书。

Type:	SecureString
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificatePath

指定分发点使用的 PKI 颁发的证书的导入路径。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientCommunicationMode

Type:	ComputerCommunicationType
Accepted values:	Http, Https
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClientConnectionType

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

• Internet
• InternetAndIntranet
• Intranet

Type:	ClientConnectionTypes
Accepted values:	Intranet, Internet, InternetAndIntranet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentValidationPriority

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

• 高
• Highest
• 低
• Lowest
• 中

默认值为“最低”。

Type:	Priority
Accepted values:	Lowest, Low, Medium, High, Highest
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationSiteCode

Type:	String
Aliases:	SiteCode
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableAnonymous

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableNonWdsPxe

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

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnablePxeSupport

指示是否在分发点上启用 PXE。

启用 PXE 时，Configuration Manager在服务器上安装 Windows 部署服务（如果需要）。 Windows 部署服务是执行 PXE 启动以安装操作系统的服务。 创建分发点后，Configuration Manager在 Windows 部署服务中安装使用 PXE 启动函数的提供程序。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableUnknownComputerSupport

指示是否启用对未知计算机的支持。 未知计算机不是由 Configuration Manager 管理的计算机。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWhenDuplicateCertificate

指示在为分发点导入 PKI 客户端证书时，Configuration Manager是否覆盖重复证书。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

此参数处理通配符，并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InitiateConnection

指示分发点是否启动与客户端的连接。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Type:	IResultObject
Aliases:	SharedDistributionPoint
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallationAccount

指定站点系统安装帐户。 Configuration Manager 2007 站点组件管理器 服务使用站点系统安装帐户来安装、重新安装、卸载和配置站点系统。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallIis

Type:	Boolean
Aliases:	InstallInternetServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MacAddressForRespondingPxeRequest

指定一个媒体访问控制器数组， (MAC) 地址，分发点用来响应预启动执行环境 (PXE) 请求。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinFreeSpaceMB

指定在Configuration Manager选择其他驱动器并继续复制到该驱动器之前驱动器上的可用空间量。 内容文件可以跨多个驱动器。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PathForSavingMigratedPackage

指定已迁移内容的副本的路径。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryContentLibraryLocation

指定主要内容位置。 Configuration Manager将内容复制到主要内容位置，直到可用空间量达到为 MinFreeSpaceMB 参数指定的值。 有效值包含:

• 自动。
• 驱动器号从 A：到 Z：。

Type:	DriveType
Accepted values:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PrimaryPackageShareLocation

指定主包共享位置。 Configuration Manager将内容复制到主包共享位置，直到可用空间量达到为 MinFreeSpaceMB 参数指定的值。 有效值包含:

• 自动。
• 驱动器号从 A：到 Z：。

Type:	DriveType
Accepted values:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicFqdn

指定托管分发点的站点系统服务器的完全限定域名 (FQDN) 。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PxePassword

Type:	SecureString
Aliases:	ComputersUsePxePassword
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PxeServerResponseDelaySec

Type:	Int32
Aliases:	PxeServerResponseDelaySeconds
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryContentLibraryLocation

指定辅助内容位置。 有效值包含:

• 自动。
• 驱动器号从 A：到 Z：。

Type:	DriveType
Accepted values:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SecondaryPackageShareLocation

指定辅助包共享位置。 有效值包含:

• 自动。
• 驱动器号从 A：到 Z：。

Type:	DriveType
Accepted values:	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
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserDeviceAffinity

指定分发点如何将用户与 PXE 部署的目标计算机相关联。 有效值包含:

• AllowWithAutomaticApproval
• AllowWithManualApproval
• DoNotUse

Type:	UserDeviceAffinityType
Accepted values:	DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ValidateContentSchedule

指定 CMSchedule 对象。 CMSchedule 对象定义用于验证分发点上内容文件完整性的计划。 若要创建 CMSchedule 对象，请使用 New-CMSchedule cmdlet。

Type:	IResultObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

相关链接

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