Share via

ConvertTo-FIMResource

  • Article

ConvertTo-FIMResource

Deserializes FIMResource objects from the given file.

Syntax

ConvertTo-FIMResource [-file] <string> [<CommonParameters>]

Detailed Description

The ConvertTo-FIMResource cmdlet deserializes XML resources used elsewhere in the Microsoft® Forefront Identity Manager (FIM) 2010 Windows PowerShell™ cmdlet set. The cmdlet returns ExportObject, ImportObject, and MatchObjects. This is the complement cmdlet to ConvertFrom-FIMResource.

The cmdlet deserializes the objects by using XmlObjectSerializer in Windows .NET.

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

For more information about the Microsoft® Forefront Identity Manager (FIM) 2010 Windows PowerShell™ cmdlet set see Forefront Identity Manager Configuration with Windows PowerShell

Parameters

--File <string>

Specifies the file to read FIM resource objects from. The following is an example use of this parameter:

-file C:\Fabrikam FIM Configuration\config002.xml

Attributes

Name Value

Required?

false

Accept Wildcard Characters?

false

Accept Pipeline Input?

false

Position?

named

--CommonParameters

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

-CommonParameter

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, and OutVariable. For more information, see about_CommonParameters.

Input and Return Types

The input type is the type of the objects that you can pipe to the cmdlet. The return type is the type of the objects that the cmdlet emits.

Examples

EXAMPLE 1

Command prompt:

 
          $pilot = ConvertTo-FIMResource -file pilot.xml 
          $matches = Join-FIMConfig -source $pilot -target $production -defaultJoin "DisplayName"

This is a simple example of how you can deserialize ExportObject instances that were serialized on another system.

See Also

Reference

Export-FIMConfig
Join-FIMConfig
Compare-FIMConfig
Import-FIMConfig
ConvertFrom-FIMResource