New-DPMServerScope
Creates a DPM server scope object.
Syntax
Default (Default)
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 "00a000aa-00a0-00aa-00aa-0a0aa000aa00" -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
Parameter properties
| Type: | AlertEnum |
| Default value: | None |
| 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 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DetailedErrorId
Specifies the ID of a detailed error.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DPMServerName
Specifies the name of a DPM server for which this cmdlet creates a server scope.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ErrorId
Specifies the ID of an error.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ObjectId
Specifies an array of IDs for objects that scope a connection.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | ScopedObjectType |
| Default value: | None |
| Accepted values: | DpmServer, Datasource, ProtectionGroup, ProductionServer, Disk, Volume, Library, Drive, AdhocAction |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.