Wednesday, May 09, 2012

Set-MIISFIMMAConfiguration

Gotta love the discoverability of PowerShell.  It is so easy to find out what the platform can do for you, all without looking at the documentation.

Today I was importing a FIM Sync configuration using the trusty MIIS.MA.Config PowerShell snap-in (that has been around since ILM 2007, and still works with FIM despite the legacy name!).  I tend to press TAB instead of typing full command names in PowerShell, and this morning I pressed TAB too many times and to my surprise there was a new command!

This new cmdlet allows scripted configuration of a FIM MA, including setting the password.  This is one of the new things that I had not been automating in my deployments, and now I can get to 100% automation for more scenarios.

AWESOME!

BTW – I assume this cmdlet is only in the R2 version of the snap-in. 


NAME


    Set-MIISFIMMAConfiguration
   

SYNOPSIS


   

SYNTAX


    Set-MIISFIMMAConfiguration [-AuthenticationMode <String>] -Credentials <PSCredential> [-DatabaseName <String>] [-Da
    tabaseServer <String>] [-FIMServiceBaseAddress <String>] [-MAName] <String> [-WarningAction <ActionPreference>] [-W
    arningVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]  
   

DESCRIPTION 

PARAMETERS


    -AuthenticationMode <String>


        The authentication mode for the FIM service database connection.
       
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -Credentials <PSCredential>


        Credentials for authenticating with the FIMService database.
       
        Required?                    true
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -DatabaseName <String>


        The FIM Service database name.
       
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -DatabaseServer <String>


        The FIM Service database server.
       
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -FIMServiceBaseAddress <String>


        The FIM service base uri.
       
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -MAName <String>


        The name of the management agent to update. Get this name from the MIIS tool.
       
        Required?                    true
        Position?                    1
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -WarningAction <ActionPreference>    


        
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -WarningVariable <String>     


        
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -WhatIf    


        
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    -Confirm


              
        Required?                    false
        Position?                    named
        Default value               
        Accept pipeline input?       false
        Accept wildcard characters?  false
       

    <CommonParameters>


        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer and OutVariable. For more information, type,
        "get-help about_commonparameters".
   

INPUTS  


   

OUTPUTS  


   

NOTES


    
    --------------  EXAMPLE 1 --------------
   
    C:\PS>set-MIISFIMMAConfiguration -AuthenticationMode integrated -Credentials <credential object> -DatabaseName FIMS
    ervice -DatabaseServer localhost -FIMServiceBaseAddress
http://localhost:5725 -MAName "Fabrikam FIM MA"
      
    Configures the FIM MA database connection info and FIM service URI.
     

RELATED LINKS

Monday, May 07, 2012

FIM PowerShell Modules Released

Recently I delivered a workshop at The Experts Conference in San Diego.  The delivery lasted four hours, all involved are healthy and the proud recipients of some PowerShell modules.  The modules are now released on CodePlex:

FimPowerShellModule.CodePlex.com

The star of the show is really the FIM Service module.  It depends heavily on the FimAutomation PowerShell Snap-In which ships with FIM.  This buys the module a nice support story since the cmdlets in that snap-in are released and supported by Microsoft.  While the cmdlets are intended for configuration migration, the functions in the module demonstrate that they can also be used to accomplish CRUD operations against the FIM Service, and be combined for simple yet powerful automation scenarios in FIM.

Everybody using FIM should be doing automation like this, and I hope the modules illustrate how PowerShell amplifies skill sets and extends the reach and extensibility of products like FIM.

If you like the module then please file a review on CodePlex.  If you don’t like the module, then maybe skip the review and instead please file bugs for any issues you find.  Happy automating!