ConvertTo-FIMResource

Reference

Module:: FIMAutomation

Deserializes FIMResource objects from the given file.

Syntax

ConvertTo-FIMResource
              [-File <String>]
              [-WhatIf]
              [-Confirm]
              [<CommonParameters>]

Description

The ConvertTo-FIMResource cmdlet deserializes XML resources used elsewhere in themmseeWindows PowerShell™ cmdlet set. The cmdlet returns ExportObject, ImportObject, and MatchObjects. This is the complement cmdlet to ConvertFrom-FIMResource .

The cmdlet deserializes the objects by usingXmlObjectSerializerin 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 themmseeWindows PowerShell™ cmdlet set see about_FIM.

Examples

EXAMPLE 1

$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.

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

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

None

This cmdlet takes no input.

Outputs

FIMResource

The return type could be ImportObject[], ExportObject[], or MatchObject[], depending on which type is stored in the file. You only get back homogeneous types from this deserialization.

Share via