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>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer、および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上に失われた構成ファイルを再生成します。
[参考]
- DPM Cmdlet Help – System Center 2012 Data Protection Manager
http://technet.microsoft.com/en-us/library/hh881679.aspx - Set-DPMCredentials – System Center 2012 Data Protection Manager
http://technet.microsoft.com/en-us/library/hh881602.aspx
コメント
[…] Set-DPMCredentials […]
[…] DPM 2012のDPM管理シェルで使用できるコマンドレット (Set-DPMCredentials) について | 焦げloghttps://kogelog.com/2012/08/08/20120808-03/ […]