New-DPMServerScope
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 $ServerScopeThe 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 $ServerScopeThe 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 |