System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレット (New-DPMServerScope) について

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

DPM 管理シェルは、デスクトップ上のアイコン、もしくは [スタートメニュー] – [Microsoft System Center 2016] – [DPM 管理シェル] を選択、クリックすることで起動することが可能です。

DPM 2016 の管理を目的として様々なコマンドレットが DPM 管理シェルに用意されていますが、コマンドレットのヘルプについては、日本語の情報は公開されていません。

このヘルプ情報について、「Get-Help」コマンドレットの -Full オプションを用いて実行した結果を編集、意訳しました。

この記事では、「New-DPMServerScope」コマンドレットについて記載します (他のコマンドレットについては、「System Center 2016 – Data Protection Manager の DPM 管理シェルで使用できるコマンドレットについて」を参照)。

New-DPMServerScope コマンドレット

名前

New-DPMServerScope

概要

DPM サーバースコープオブジェクトを作成します。

構文

New-DPMServerScope [[-DPMServerName] <String>] [-ObjectType] {DpmServer | Datasource | ProtectionGroup | ProductionServer | Disk | Volume | Library | Drive | AdhocAction} [-ObjectId] <String[]> [-AlertType {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 | SLAMissedAlert | OfflineInitialCloudBackupPendingAlert | RestoreDBAlert}] [-DetailedErrorId <Int32>] [-ErrorId <Int32>] [<CommonParameters>]

説明

New-DPMServerScope コマンドレットは、System Center 2016 – Data Protection Manager (DPM) サーバースコープオブジェクトを作成します。スコープオブジェクトを含むコマンドレットを使用すると、スコープ化された DPM サーバー接続の作成が可能です。

パラメーター

-AlertType [<AlertEnum>]

接続スコープのアラートの種類を指定します。

このパラメーターで利用可能な値 :

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

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

-DetailedErrorId [<Int32>]

詳細エラー ID を指定します。

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

-DPMServerName [<String>]

このコマンドレットが、サーバースコープを作成する DPM サーバー名を指定します。

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

-ErrorId [<Int32>]

エラー ID を指定します。

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

-ObjectId <String[]>

スコープを接続するオブジェクト ID の配列を指定します。

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

-ObjectType <ScopedObjectType>

-ObjectId パラメーターで定義されたオブジェクトの種類を指定します。

このパラメーターで利用可能な値 :

Datasource : DatasourceID
ProtectionGroup : ProtectionGroupID / ProtectionGroupName
ProductionServer : ProductionServerID / ProductionServerName
Disk : DiskID
Volume : VolumeID
Library : LibraryID
Drive : DriveID
AdhocAction : ActionID
DPMServer : DPMServerName

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

<CommonParameters>

このコマンドレットは、次の共通パラメーターをサポートします: -Verbose、-Debug、-ErrorAction、-ErrorVariable、-WarningAction、-WarningVariable、-OutBuffer、-PipelineVariable、および -OutVariable。詳細については、about_CommonParameters を参照してください。

入力

入力の種類は、コマンドレットにパイプ可能なオブジェクトの種類です。

出力

出力の種類は、コマンドレットが発行するオブジェクトの種類です。

例

例 1 : 接続用のサーバースコープの作成

$ServerScope = New-DPMServerScope -DPMServerName "DPMServer07" -ObjectType ProtectionGroup -ObjectID "Protection Group 01"
$DpmServer = Connect-DPMServer -DPMServerScope $ServerScope

最初のコマンドは、DPM サーバー「DPMServer07」のサーバースコープを作成し、変数 $ServerScope に格納します。このコマンドは、オブジェクト ID「Protection Group 01」を持つオブジェクトの種類として ProtectionGroup を指定します。

2 番目のコマンドは、Connect-DPMServer コマンドレットを用いて $ServerScope のサーバースコープを持つ接続を作成します。

例 2 : 指定したアラートを持つサーバースコープを作成する

$ServerScope = New-DPMServerScope -DPMServerName "DPMServer07" -ObjectType Datasource -ObjectID "70fd1133-1bab-4178-8e8c-24d928b6b16c" -AlertType BackupToTapeFailedAlert -DetailedErrorID 910 -ErrorID 3113
$DpmServer = Connect-DPMServer -DPMServerScope $ServerScope

最初のコマンドは、DPM サーバー「DPMServer07」のサーバースコープを作成し、変数 $ServerScope に格納します。このコマンドは、オブジェクトの種類として Datasource およびオブジェクト ID を指定します。このコマンドでは、アラートの種類、詳細エラー ID およびエラー ID の両方を指定します。