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

{{Fill File 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

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.