System Center 2012 R2 – Data Protection Manager (SC 2012 R2 – DPM) の DPM 管理シェルは、PowerShell を用いたコマンドラインインタフェースです。
DPM 管理シェルは、デスクトップ上のアイコン、もしくはスタート画面の [DPM 管理シェル] を選択、クリックすることで起動することが可能です。
SC 2012 Service Pack1 RollUp 2 – DPM 以降と同様に、SC 2012 R2 – DPM の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、 コマンドレットのヘルプについては、日本語の情報は公開されていません。
このヘルプ情報について、 「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。
この記事では、「New-DPMServerScope」コマンドレットについて記載します (他のコマンドレットについては、「SC 2012 R2 – DPM の DPM 管理シェルで使用できるコマンドレットについて」を参照)。
■名前
New-DPMServerScope
■概要
Connect-DPMServer コマンドレットにより作成した選択された DPM 接続を用いて範囲オブジェクトを作成する。
■構文
New-DPMServerScope [[-DPMServerName] <String>] [-ObjectType] {DpmServer | Datasource | ProtectionGroup | ProductionServer | Disk | Volume | Library | Drive | AdhocAction} [-ObjectId] <String[]> [-AlertType {RestoreDBAlert | NullType | AgentIncompatibleAlert | AgentUnreachableAlert | MediaVerificationFailedAlert | MediaEraseFailedAlert | DetailedInventoryFailedAlert | MediaDecommissionedAlert | MediaDataEraseAlert | FreeMediaThresholdAlert | DataSetCopyFailedAlert | BackupToTapeFailedAlert | BackupToTapeCatalogFailedAlert | LibraryDriveAlert | LibraryNotAvailableAlert | LibraryNotWorkingEfficientlyAlert | MediaRequiredAlert | ReplicaInitializationInProgressAlert | SynchronizationFailedAlert | StopProtectionFailedAlert | RecoveryInProgressAlert | RecoveryPartiallySuccessfulAlert | RecoverySuccessfulAlert | RecoveryFailedAlert | ShadowCopyFailedAlert | ReplicaInMissingStateAlert | ReplicaInInvalidStateAlert | PartialDeployedClusterAlert | AgentTaskFailAlert | SqmOptInAlert | DiskThresholdCrossedAlert | VerificationInProgressAlert | DiskMissingAlert | CatalogThresholdCrossedAlert | DatasetDataVerificationFailed | SCDiskThresholdCrossedAlert | ConfigureProtectionFailedAlert | ReplicaManualLoadPendingAlert | ReplicaInitializationPendingAlert | CertificateExpiringAlert | EvalShareInquiryAlert | ShadowCopyConsolidationRequired | PathChangedForShareAlert | BackupMetadataEnumerationFailedAlert | DuplicateDisksDetectedAlert | DataCorruptionDetectedAlert | DataCorruptionDetectedDuringReadAlert | StagingAreaRestoreInProgressAlert | StagingAreaRestorePartiallySuccessfulAlert | StagingAreaRestoreSuccessfulAlert | StagingAreaRestoreFailedAlert | AgentOwnershipRequiredAlert | AutoInstanceProtectionFailedAlert | AgentAttachFailedAlert | BackupSLAFailedAlert | DpmoRPCreationFailureAlert | DOCVolumeMissing | SharepointROAddedAlert | SharepointRORemovedAlert | PartialBackupSuccessAlert | GlobalDbNotAvailable | LibraryDevicesDisabledAlert | LdmWarningThresholdReachedAlert | LdmErrorThresholdReachedAlert | CertificateExpiryWarningAlert | CertificateExpiryErrorAlert | RecoveryFailedWarningAlert | ExternalAlert | OnlineBackupServiceUnreachableAlert | OnlineBackupPoliciesInconsistentAlert | CloudBackupFailedAlert | PartialCloudBackupSuccessAlert}] [-DetailedErrorId <Int32>] [-ErrorId <Int32>] [<CommonParameters>] |
■説明
New-DPMServerScope コマンドレットにより、Connect-DPMServer コマンドレットにより作成した選択された DPM 接続を用いて範囲オブジェクトを作成する。
■パラメーター
-AlertType <AlertEnum>
選択された接続の警告の型。
必須 | false |
位置 | named |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-DetailedErrorId <Int32>
警告のエラー ID の詳細。
必須 | false |
位置 | named |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-DPMServerName <String>
DPM サーバーの名前。
必須 | false |
位置 | 1 |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-ErrorId <Int32>
警告のエラー ID。
必須 | false |
位置 | named |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-ObjectId <String[]>
接続されているオブジェクトのユニークな識別子は、スコープ化されます。 以下は、オブジェクト型とユニークな識別子です:
- データソース – DatasourceID
- 保護グループ – ProtectionGroupID/ProtectionGroupName
- 保護サーバー – ProductionServerID/ProductionServerName
- ディスク – DiskID
- ボリューム – VolumeID
- ライブラリ – LibraryID
- ドライブ – DriveID
- アドホックアクション – ActionID
- DPMサーバー- DPMServerName
必須 | true |
位置 | 3 |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
-ObjectType <ScopedObjectType>
ObjectId が定義されたオブジェクト型を記述する。
必須 | true |
位置 | 2 |
既定値 | none |
パイプライン入力を許可する | false |
ワイルドカード文字を許可する | false |
<CommonParameters>
このコマンドレットは、次の共通パラメーターをサポートします: Verbose、Debug、ErrorAction、ErrorVariable、WarningAction、WarningVariable、OutBuffer, PipelineVariable、および OutVariable。詳細については、about_CommonParameters を参照してください。
■入力
- 入力タイプは、コマンドレットへパイプすることができるオブジェクトのタイプです。
■出力
- 出力タイプは、コマンドレットが発行するオブジェクトのタイプです。
■メモ
- 詳細については、「Get-Help New-DPMServerScope -detailed」と入力してください。
- 技術情報については、「Get-Help New-DPMServerScope -full」と入力してください。
■エイリアス
- なし。
■例
例 1
$Scope=New-DPMServerScope -DPMServerName "TestingServer" -ObjectType ProtectionGroup -ObjectID "Protection Group1" $DPMServer=Connect-DPMServer -DPMServerScope $Scope
このコマンドにより、保護グループ Protection Group1 が選択された DPM サーバー TestingServer への接続を生成します。
例 2
$Scope=New-DPMServerScope -DPMServerName "TestingServer" -ObjectType Datasource -ObjectID 70fd1133-1bab-4178-8e8c-24d928b6b16c -AlertType BackupToTapeFailedAlert -ErrorID 3113 -DetailedErrorID 910 $DPMServer=Connect-DPMServer -DPMServerScope $Scope
このコマンドにより、データソース ID 70fd1133-1bab-4178-8e8c-24d928b6b16c が選択された DPM サーバー TestingServer への接続を生成します。接続による警告は、エラーID 3113 および詳細なエラー ID 910 の BackupToTapeFailedAlert 警告の型を選択します。
■関連するトピック
[参考]
- Cmdlet Reference (SC 2012 R2 – DPM)
http://technet.microsoft.com/en-us/library/hh881679(v=sc.20).aspx - New-DPMServerScope (SC 2012 R2 – DPM)
http://technet.microsoft.com/en-us/library/hh881718(v=sc.20).aspx - DPM 2012のDPM管理シェルで使用できるコマンドレット (New-DPMServerScope) について | 焦げlog
https://kogelog.com/2012/08/01/20120801-02/
コメント
[…] New-DPMServerScope […]