DPM 2012のDPM管理シェルで使用できるコマンドレット (Set-DPMCredentials) について

スポンサーリンク

System Center 2012 Data Protection Manager (DPM 2012) のDPM管理シェルは、PowerShellを用いたコマンドラインインタフェースです。

DPM管理シェルは、DPM 2012の管理を目的として様々なコマンドレットが用意されていますが、 コマンドレットのヘルプについて、英語の情報のみのようです。

このヘルプ情報について、オンライン上で日本語として確認したいと思い、本ブログ上で纏めてみることにしました (内容については「Get-Help」コマンドレットの-Fullオプションを用いて実行した結果を編集、意訳したものとなります)。

この記事では、「Set-DPMCredentials」コマンドレットについて記載します (他のコマンドレットについては、「DPM 2012のDPM管理シェルで使用できるコマンドレット一覧について」を参照)。

■名前

Set-DPMCredentials

■概要

証明書ベースの認証を構成します。

■構文

Set-DPMCredentials [-DPMServerName] <String> [-Type] <AuthenticationType>
     [-Action] <Action> [-OutputFilePath] <String> [[-Thumbprint] <String>]
     [[-AuthCAThumbprint] <String>] [-Confirm [<SwitchParameter>]]
     [-WhatIf [<SwitchParameter>]] [<CommonParameters>]

■説明

Set-DPMCredentialsコマンドレットは、コンピュータを保護したいが信頼することができないドメインに対して証明書ベースの認証を構成することを許可します。

■パラメーター

-Action <Action>
実行するアクションを示します。これは、値を構成するか、もしくは再生成するか選択することが可能です。「Configure」を使用する場合、新しい証明書を用います。「Regenerate」は再生成したものをメタデータファイルとして出力します。

必須true
位置3
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-AuthCAThumbprint <String>
認証局が信頼している証明書チェーンの拇印。任意です。指定がない場合は、ルートが使用されます。

必須false
位置6
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-DPMServerName <String>
DPMサーバーの名前。

必須true
位置1
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-OutputFilePath <String>
出力ファイルの場所 (保護されたコンピューター上のSet-DPMServerで使用されます)。

必須true
位置4
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Thumbprint <String>
拇印は、証明書を見つけるのに使用します。 アクションを「Configure」を指定する場合、このパラメータは必要です。

必須false
位置5
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Type <AuthenticationType>
追加されている証明書のタイプを示します。 値は「Certificate」を選択することが可能です。

必須true
位置2
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-Confirm [<SwitchParameter>]
コマンドを実行する前に実行の是非を確認するプロンプトを表示します。

必須false
位置named
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

-WhatIf [<SwitchParameter>]
実際にコマンドを実行せずに、コマンドを実行すると何が起きるかを出力します。

必須false
位置named
規定値
パイプライン入力を許可するfalse
ワイルドカード文字を許可するfalse

<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: VerboseDebugErrorActionErrorVariableWarningActionWarningVariableOutBuffer、およびOutVariable。詳細については、「get-help about_commonparameters」と入力してヘルプを参照してください。

■入力

■出力

■メモ

詳細については、「Get-Help Set-DPMCredentials -detailed」と入力してください。
技術情報については、「Get-Help Set-DPMCredentials -full」と入力してください。

■例

例1

Set-DPMCredentials –DPMServerName “dpmserver.contoso.com” -Type Certificate -Action Configure -OutputFilePath c:CertMetaData –Thumbprint “cf822d9ba1c801ef40d4b31de0cfcb200a8a2496”

このコマンドにより、c:CertMetaDataフォルダ上にCertificateConfiguration_<DPM SEVER FQDN>.binという名前を持つファイルを生成します。

例2

Set-DPMCredentials –DPMServerName “dpmserver.contoso.com” -Type Certificate “-OutputFilePath c:CertMetaData -Action Regenerate

このコマンドにより、c:CertMetaData上に失われた構成ファイルを再生成します。

[参考]

コメント

  1. […] DPM 2012のDPM管理シェルで使用できるコマンドレット (Set-DPMCredentials) について | 焦げloghttp://kogelog.com/2012/08/08/20120808-03/ […]