.SYNOPSIS

Creates a new ImportChange object for the FIM Configuration Migration Cmdlets

.DESCRIPTION

The New-FimImportChange function makes it easier to use Import-FimConfig by providing an easier way to create ImportChange objects. ImportChange objects describe the changes to include in a new FIM Request. For example, if you are creating a new Person object, you will include one ImportChange object for every property you want to set on the new Person. For an update, you would include one ImportChange object per property that you want to add/remove/change.
This makes it easier to perform CRUD operations in the FIM Service.

.PARAMETER AttributeName

The name of the attribute in the FIM Service.
NOTE: this is case sensitive
NOTE: this is the AttributeTypeDescription's 'name' attribute, which often does NOT match what is seen in the FIM Portal.

.PARAMETER AttributeValue

The value for the attribute in the FIM Service.
or
An Array of three items in the format of:
@(
ObjectType
SearchAttribute
SearchValue
)
An array can be specified for the AttributeValue for resolving references. For example, to set Craig's manager to Britta Simon you could do this:
New-FimImportChange -Operation Replace-AttributeName 'Manager'-AttributeValue @('Person','DisplayName','Britta Simon')

.PARAMETER Operation

The operation to perform on the target, must be one of:
-Replace
-Add (for multi-valued attributes)
-Delete (for multi-valued attributes)
-None

.PARAMETER FullyResolved

Not intelligently used or tested yet...

.PARAMETER FullyResolved

Not intelligently used or tested yet...
Defaults to 'true'

.PARAMETER Locale

Not intelligently used or tested yet...
Defaults to 'Invariant'

.PARAMETER Uri

The Uniform Resource Identifier (URI) of themmsshortService. The following example shows how to set this parameter: -uri "http://localhost:5725"

.OUTPUTS

The FIM ImportChange is returned by this function.

.EXAMPLE

Creates an ImportObject for creating a new Person object with AccountName and DisplayName.
This exmaple uses an array of ImportChange objects for the Changes parameter.
NOTE: the attribute 'Operation' type of 'None' works when the object 'State' is set to 'Create'.
New-FimImportObject -ObjectType Person -State Create -Changes @(
   New-FimImportChange -Operation None -AttributeName 'FirstName' -AttributeValue 'Britta' 
   New-FimImportChange -Operation None -AttributeName 'DisplayName' -AttributeValue 'Britta Simon' 
) -ApplyNow

.EXAMPLE

Creates an ImportObject for updating Craig's manager to Britta Simon.
This exmaple uses an array for the ImportChange AttributeValue to calculate a reference.
New-FimImportObject -ObjectType Person -State Put -Anchor @{AccountName='Craig'} -Changes @(
   New-FimImportChange -Operation Replace-AttributeName 'Manager'-AttributeValue @('Person','DisplayName','Britta Simon') 
) -ApplyNow

.EXAMPLE

Creates an ImportObject for updating Craig's manger to Bob.
This example uses an array for the ImportChange AttributeValue to calculate a reference, but uses a HashTable to simplify the script.
New-FimImportObject -ObjectType Person -State Put -Anchor @{AccountName='Craig'} -Changes @{
   Manager = ('Person','DisplayName','Britta') 
} -ApplyNow


Last edited Dec 31, 2016 at 6:07 PM by bdesmondMVP, version 4

Comments

No comments yet.