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 配布ポイントでホストされていた移行されたコンテンツを再配布する必要はありません。

注:

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

例

例 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

クライアントがコンテンツにフォールバックソースの場所を使用できるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowPreStaging

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AllowRespondIncomingPxeRequest

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificateExpirationTimeUtc

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

型:	DateTime
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificatePassword

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

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CertificatePath

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

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClientCommunicationMode

型:	ComputerCommunicationType
指定可能な値:	Http, Https
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClientConnectionType

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

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

型:	ClientConnectionTypes
指定可能な値:	Intranet, Internet, InternetAndIntranet
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ContentValidationPriority

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

高い
最高
低い
最低
中

既定値は [最小] です。

型:	Priority
指定可能な値:	Lowest, Low, Medium, High, Highest
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestinationSiteCode

型:	String
Aliases:	SiteCode
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DisableWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableAnonymous

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableNonWdsPxe

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnablePxeSupport

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

PXE を有効にすると、必要に応じて Configuration Manager によって Windows 展開サービスがサーバーにインストールされます。 Windows 展開サービスは、オペレーティングシステムをインストールするために PXE ブートを実行するサービスです。配布ポイントを作成すると、Configuration Manager は PXE ブート機能を使用するプロバイダーを Windows Deployment Services にインストールします。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-EnableUnknownComputerSupport

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWhenDuplicateCertificate

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InitiateConnection

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

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

型:	IResultObject
Aliases:	SharedDistributionPoint
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-InstallationAccount

サイトシステムのインストールアカウントを指定します。 Configuration Manager 2007 Site Component Manager サービスでは、サイトシステムのインストールアカウントを使用して、サイトシステムのインストール、再インストール、アンインストール、構成を行います。

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InstallIis

型:	Boolean
Aliases:	InstallInternetServer
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MacAddressForRespondingPxeRequest

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

型:	String[]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-MinFreeSpaceMB

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

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PathForSavingMigratedPackage

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

型:	String
配置:	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
配置:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PublicFqdn

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PxePassword

型:	SecureString
Aliases:	ComputersUsePxePassword
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PxeServerResponseDelaySec

型:	Int32
Aliases:	PxeServerResponseDelaySeconds
配置:	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
配置:	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
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UserDeviceAffinity

配布ポイントが PXE 展開の対象コンピューターにユーザーを関連付ける方法を指定します。有効な値は次のとおりです。

AllowWithAutomaticApproval
AllowWithManualApproval
DoNotUse

型:	UserDeviceAffinityType
指定可能な値:	DoNotUse, AllowWithManualApproval, AllowWithAutomaticApproval
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ValidateContentSchedule

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

型:	IResultObject
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

次の方法で共有