Share via

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 - 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.

The acceptable values for this parameter are:

  • Datasource. DatasourceID.
  • ProtectionGroup. ProtectionGroupID/ProtectionGroupName.
  • ProductionServer. ProductionServerID/ProductionServerName.
  • Disk. DiskID.
  • Volume. VolumeID.
  • Library. LibraryID.
  • Drive. DriveID.
  • AdhocAction. ActionID.
  • DPMServer. DPMServerName.
Type:ScopedObjectType
Accepted values:DpmServer, Datasource, ProtectionGroup, ProductionServer, Disk, Volume, Library, Drive, AdhocAction
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False