ConvertFrom-FIMResource

  • Reference
Module:
FIMAutomation

Serializes FIMResource objects and stores them in the given file.

Syntax

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

Description

The ConvertFrom-FIMResource in the Windows PowerShell™ command-line interface 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 ofExport-ClixmlbecauseExport-Clixmldoes 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.

For more information about themmseeWindows PowerShell™ cmdlet set see about_FIM.

Examples

EXAMPLE 1

$pilot =  Export-FIMConfig  -uri http://localhost:5725/ResourceManagementService -policyConfig $pilot |  ConvertFrom-FIMResource  -file pilot.xml

This is a simple example of how you can serialize ExportObject objects to transport across a firewall.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-File

{{Fill File Description}}

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

-Objects

{{Fill Objects Description}}

Type:BaseObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ObjectType

{{Fill ObjectType Description}}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

ExportObject[] | ImportObject[] | MatchObject[]

The resources to serialize.

Outputs

None

There is no return value.