ConvertFrom-FIMResource

Serializes FIMResource objects and stores them in the given file.

Syntax

ConvertFrom-FIMResource
           [-Confirm]
           [-File <String>]
           [-Objects <BaseObject>]
           [-ObjectType <String>]
           [-WhatIf]

Description

The ConvertFrom-FIMResource cmdlet serializes into XML resources used elsewhere in the Forefront Identity Manager (FIM) Automation snap-in. The cmdlet takes ExportObject, ImportObject, or MatchObject instances as input. With this cmdlet, you can save intermediate work and transfer it among computers.

The cmdlet serializes the resources by using XmlObjectSerializer in Microsoft .NET. You must use this cmdlet instead of Export-Clixml because that cmdlet does not preserve nested and complex types.

To help distinguish ConvertTo-FIMResource from ConvertFrom-FIMResource, remember that you are converting from FIM resources to a file.

Examples

Example 1: Serialize ExportObject objects

$Pilot =  Export-FIMConfig  -Uri http://localhost:5725/ResourceManagementService -PolicyConfig $Pilot |  ConvertFrom-FIMResource  -File pilot.xml

This command shows how you can serialize ExportObject objects for transport across a firewall.

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-File

Specifies the filename that contains the objects that this cmdlet converts.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ObjectType

Specifies the object type.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Objects

Specifies the objects that this cmdlet converts.

Type:BaseObject
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

ExportObject[] | ImportObject[] | MatchObject[]

Specifies the resources that this cmdlet serializes.

Outputs

None

There is no return value.