ConvertFrom-FIMResource
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.