Start-CMDistributionPointUpgrade

升级共享分发点。

语法

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