| external help file | Module Name | online version | schema |
|---|---|---|---|
AMSoftware.Crm.PowerShell.Commands.dll-Help.xml |
AMSoftware.Crm |
2.0.0 |
Disassociate one record from another.
Split-CrmContent [-InputObject] <Entity> [-FromEntity] <String> [-FromId] <Guid> [-Attribute <String>]
[-AsBatch] [<CommonParameters>]
Split-CrmContent [-Entity] <String> [-Id] <Guid> [-FromEntity] <String> [-FromId] <Guid> [-Attribute <String>]
[-AsBatch] [<CommonParameters>]
Disassociate one record from another.
This can be used to clear lookups (instead of Set-CrmContent), but is most usefull for breaking associated records in many-to-many relations.
PS C:\> Split-CrmEnity -Entity 'contact' -Id '53B38B4C-7A26-4731-84A3-6A3229F9CC60' -FromEntity 'account' -FromId '76629DD4-7A1A-4F47-BEEA-5D881676938C' -Attribute 'primarycontactid'
Disassociate the specified contact from the specified account for attribute 'primarycontactid'
Execute the request as part of a batch (ExecuteMultiple or ExecuteTransaction). See Start-CrmBatch, Stop-CrmBatch and Submit-CrmBatch.
Type: System.Management.Automation.SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe LogicalName of the attribute on the target entity to clear the association for.
If the relationship between the entity and target entity is unique this parameter is not required.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe LogicalName of the entity to disassociate.
Type: System.String
Parameter Sets: SplitContent
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe LogicalName of the entity disassociate the record from.
Type: System.String
Parameter Sets: (All)
Aliases:
Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe id of the record of the entity to disassociate the record from.
Type: System.Guid
Parameter Sets: (All)
Aliases:
Required: True
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: FalseThe id of the record of the entity to disassociate.
Type: System.Guid
Parameter Sets: SplitContent
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseThe entity record to disassociate.
Type: Microsoft.Xrm.Sdk.Entity
Parameter Sets: SplitContentByInputObject
Aliases: Record
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: FalseThis cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.