New-DPMServerScope

Reference

Module:: DataProtectionManager

Creates a DPM server scope object.

Syntax

New-DPMServerScope
   [[-DPMServerName] <String>]
   [-ObjectType] <ScopedObjectType>
   [-ObjectId] <String[]>
   [-AlertType <AlertEnum>]
   [-ErrorId <Int32>]
   [-DetailedErrorId <Int32>]
   [<CommonParameters>]

Description

The New-DPMServerScope cmdlet creates a System Center 2016 - Data Protection Manager (DPM) server scope object. You can create a scoped DPM server connection by using the cmdlet with a scope object.

Examples

Example 1: Create server scope for a connection

PS C:\>$ServerScope = New-DPMServerScope -DPMServerName "DPMServer07" -ObjectType ProtectionGroup -ObjectID "Protection Group 01"
PS C:\> $DpmServer = Connect-DPMServer -DPMServerScope $ServerScope

The first command creates a server scope for the DPM server named DPMServer07, and then stores that scope in the $ServerScope variable. The command specifies ProtectionGroup as the object type, with an object ID of Protection Group 01.

The second command uses the Connect-DPMServer cmdlet to create a connection that uses the server scope in $ServerScope.

Example 2: Create server scope that has alerts specified

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

The first command creates a server scope for the DPM server named DPMServer07, and then stores that scope in the $ServerScope variable. The command specifies Datasource as the object type and specifies an object ID. The command also specifies an alert type and both detailed error ID and error ID.

The second command uses the Connect-DPMServer cmdlet to create a connection that has the server scope in $ServerScope.

Parameters

-AlertType

Specifies the type of alert for the connection scope.

The acceptable values for this parameter are:

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

Type:	AlertEnum
Accepted values:	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
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DetailedErrorId

Specifies the ID of a detailed error.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DPMServerName

Specifies the name of a DPM server for which this cmdlet creates a server scope.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ErrorId

Specifies the ID of an error.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectId

Specifies an array of IDs for objects that scope a connection.

Type:	String[]
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ObjectType

Specifies the type of objects defined in the ObjectId parameter.