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コマンドレットは、共有配布ポイントを Configuration Manager 配布ポイントにアップグレードします。

Configuration Manager 2007 ソース階層から移行する場合は、共有配布ポイントをアップグレードして Configuration Manager 配布ポイントにできます。 プライマリ サイトとセカンダリ サイトの両方で配布ポイントをアップグレードできます。 アップグレード プロセスでは、Configuration Manager 2007 階層から配布ポイントが削除され、Configuration Manager 階層内のサイト システム サーバーになります。 このプロセスでは、配布ポイント上にある既存のコンテンツを配布ポイント コンピューター上の新しい場所にコピーします。 アップグレード プロセスでは、コンテンツのコピーを変更して、Configuration Manager コンテンツ展開で使用する Configuration Manager 単一インスタンス ストアを作成します。 したがって、配布ポイントをアップグレードする場合は、Configuration Manager 2007 配布ポイントでホストされた移行済みコンテンツを再配布する必要がなされません。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: 共有配布ポイントをアップグレードする

最初のコマンドは、ID 6617708D-0F98-4898-8D05-9E882C23DCB2 を持つ配布ポイント オブジェクトを取得し、オブジェクトを $CIObj 変数に格納します。

2 番目のコマンドは、$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
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPreStaging

配布ポイントがコンテンツを事前にステージできるかどうかを示します。

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

-AllowRespondIncomingPxeRequest

配布ポイントがブート前実行環境 (PXE) 要求に応答できるかどうかを示します。

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

-CertificateExpirationTimeUtc

証明書の有効期限が切れる日時を指定します。

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

-CertificatePassword

配布ポイントの公開キー基盤 (PKI) クライアント証明書のパスワードをセキュリティで保護された文字列として指定します。

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

-CertificatePath

配布ポイントが使用する PKI 発行証明書のインポート パスを指定します。

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

-ClientCommunicationMode

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

-ClientConnectionType

クライアント接続の種類を指定します。 有効な値は次のとおりです。

• インターネット
• InternetAndIntranet
• イントラネット

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-ContentValidationPriority

コンテンツ検証の優先度を指定します。 有効な値は次のとおりです。

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

既定値は [最低] です。

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

-DestinationSiteCode

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

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

-EnableAnonymous

配布ポイントが Configuration Manager クライアントからコンテンツ ライブラリへの匿名接続を許可するかどうかを示します。

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

-EnableNonWdsPxe

Configuration Manager PXE レスポンダーが配布ポイントで有効になっているかどうかを示します。 PXE レスポンダーを Windows展開サービス (WDS) なしで有効にした場合、Configuration Manager は PXE レスポンダー サービスを配布ポイントにインストールします。

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

-EnablePxeSupport

配布ポイントで PXE を有効にするかどうかを示します。

PXE を有効にした場合、Configuration Manager は必要にWindows展開サービスをサーバーにインストールします。 Windows展開サービスは、オペレーティング システムをインストールするための PXE ブートを実行するサービスです。 配布ポイントを作成した後、Configuration Manager は PXE ブート機能を使用Windows展開サービスにプロバイダーをインストールします。

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

-EnableUnknownComputerSupport

不明なコンピューターのサポートが有効かどうかを示します。 不明なコンピューターは、Configuration Manager によって管理されていないコンピューターです。

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

-ForceWhenDuplicateCertificate

配布ポイントの PKI クライアント証明書をインポートするときに、Configuration Manager が重複する証明書を上書きするかどうかを示します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-InitiateConnection

配布ポイントがクライアントとの接続を開始するかどうかを示します。

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

-InputObject

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

-InstallationAccount

サイト システム インストール アカウントを指定します。 Configuration Manager 2007 サイト コンポーネント マネージャーサービスは、サイト システム インストール アカウントを使用してサイト システムのインストール、再インストール、アンインストール、および構成を行います。

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

-InstallIis

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

-MacAddressForRespondingPxeRequest

配布ポイントがブート前実行環境 (PXE) 要求に応答するために使用するメディア アクセス コントローラー (MAC) アドレスの配列を指定します。

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

-MinFreeSpaceMB

Configuration Manager が別のドライブを選択し、そのドライブへのコピー プロセスを続行する前に、ドライブ上の空き領域の量を指定します。 コンテンツ ファイルは、複数のドライブにまたがる場合があります。

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

-PathForSavingMigratedPackage

移行されたコンテンツのコピーのパスを指定します。

Type:	String
Position:	Named
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicFqdn

配布ポイントをホストするサイト システム サーバーの完全修飾ドメイン名 (FQDN) を指定します。

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

-PxePassword

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

-PxeServerResponseDelaySec

Type:	Int32
Aliases:	PxeServerResponseDelaySeconds
Position:	Named
Default value:	None
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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-ValidateContentSchedule

CMSchedule オブジェクトを指定します。 CMSchedule オブジェクトは、配布ポイント上のコンテンツ ファイルの整合性を検証するためのスケジュールを定義します。 CMSchedule オブジェクトを作成するには 、New-CMSchedule コマンドレットを使用 します。

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

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

関連リンク

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