New-DPMServerScope

Creates a DPM server scope object.

Syntax

New-DPMServerScope [[-DPMServerName] <String>] [-ObjectType] <ScopedObjectType> [-ObjectId] <String[]>
 [-AlertType <AlertEnum>] [-DetailedErrorId <Int32>] [-ErrorId <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
Parameter Sets: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
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DetailedErrorId

Specifies the ID of a detailed error.

Type:Int32
Required:False
Position:Named
Default value:None
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
Required:False
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ErrorId

Specifies the ID of an error.

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

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

Type:String[]
Required:True
Position:3
Default value:None
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
Parameter Sets:DpmServer, Datasource, ProtectionGroup, ProductionServer, Disk, Volume, Library, Drive, AdhocAction
Required:True
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False