Use this cmdlet to create a new AllowedItemActions object that describes the actions that the sync engine may perform with items during a sync session.
PowerShell
New-AllowedItemActions
- [-AllowSourceCreate]
- [-AllowTargetCreate]
- [-AllowSourceDelete]
- [-AllowTargetDelete]
- [-AllowSourceModify]
- [-AllowTargetModify]
Description
Use the New-AllowedItemActions cmdlet to control the general behavior of Super-ExMerge with regards to item actions. When Super-ExMerge is processing items, it will compare the calculated action (create, delete, modify) against the allowed actions assigned to the SyncTask. The sync action is only performed if the related permission is set to allow such.
When using this cmdlet, any switch parameter not used equates to a DENY for that action. Running this cmdlet with no parameters sets all actions to DENY.
This provides the ability to create a one-way sync, two-way sync, or a mixture.
Examples
Example 1
PowerShell
New-AllowedItemActions -AllowTargetCreate -AllowTargetDelete -AllowTargetModify
This example creates a one-way sync of items, from the source store to the target store by allowing all actions to occur in the target store only.
Example 2
PowerShell
New-AllowedItemActions -AllowTargetCreate -AllowSourceCreate
This example creates an ItemSyncRights object that only allows for new items to be created in either side.
Parameters
-AllowSourceCreate
The AllowSourceCreate switch parameter determines whether items are allowed to be created in a source store. If this parameter is not present, items will not be allowed to be created in the source store.
When the sync engine encounters a new item in a target store, it will attempt to copy the item to the source store unless the item sync right for AllowSourceCreate is False.
-AllowTargetCreate
The AllowTargetCreate switch parameter determines whether items are allowed to be created in a target store. If this parameter is not present, items will not be allowed to be created in the target store.
When the sync engine encounters a new item in a source store, it will attempt to copy the item to the target store unless the item sync right for AllowTargetCreate is False.
-AllowSourceDelete
The AllowSourceDelete switch parameter determines whether items are allowed to be deleted in a source store. If this parameter is not present, items will not be allowed to be deleted in the source store.
When the sync engine calculates that a previously sync’d item in the target store has been deleted, it will attempt to delete the linked item in the source store unless the item sync right for AllowSourceDelete is False.
-AllowTargetDelete
The AllowTargetDelete switch parameter determines whether items are allowed to be deleted in a target store. If this parameter is not present, items will not be allowed to be deleted in the target store.
When the sync engine calculates that a previously sync’d item in the source store has been deleted, it will attempt to delete the linked item in the target store unless the item sync right for AllowTargetDelete is False.
-AllowSourceModify
The AllowSourceModify switch parameter determines whether items are allowed to be modified in a source store. If this parameter is not present, items will not be allowed to be modified in the source store.
When the sync engine calculates that a previously sync’d item in the target store has been modified, it will attempt to modify the linked item in the source store unless the item sync right for AllowSourceModify is False.
-AllowTargetModify
The AllowTargetModify switch parameter determines whether items are allowed to be modified in a target store. If this parameter is not present, items will not be allowed to be modified in the target store.
When the sync engine calculates that a previously sync’d item in the source store has been modified, it will attempt to modify the linked item in the target store unless the item sync right for AllowTargetModify is False.
Output
This cmdlet will place an AllowedItemActions object on the pipeline.
