.SYNOPSIS

Gets the a CSObject using WMI

.DESCRIPTION

The Get-MIIS_CSObject function uses the Get-WmiObject cmdlet to query for a MIIS_CSObject in FIM Sync.
MSDN has good documentation for MIIS_CSObject:
http://msdn.microsoft.com/en-us/library/windows/desktop/ms697741(v=vs.85).aspx

.PARAMETER Account

The Account name of the object to search for in an ADMA

.PARAMETER Domain

The Domain (netbios domain name) of the object to search for in an ADMA

.PARAMETER DN

The DistinguishedName of the object to search for

.PARAMETER ManagementAgent

The ManagementAgent to search in

.PARAMETER MVGuid

The Metaverse GUID to search for

.PARAMETER ComputerName

Specifies the ComputerName where FIMSync is running
(defaults to localhost)

.OUTPUTS

the MIIS_CSObject returned by WMI
If searching by MVGuid, there may be multiple CSObjects returned because an MVObject can have multiple CSObjects joined to it

.EXAMPLE

Get a CS object by domain name and account name.
Get-MIIS_CSObject -Account HoofHearted -Domain Litware -Verbose

.EXAMPLE

Get a CS object by domain name and account name, on the Sync server named IceMelted.
This is a neat illustration of the ability for WMI to be used from a computer other than the FIM server. So you could easily run the WMI-based functions from a non-FIM computer.
Get-MIIS_CSObject -Account HoofHearted -Domain Litware -ComputerName IceMelted -Verbose

.EXAMPLE

Get a CS object by management agent name and distinguished name.
Get-MIIS_CSObject -ManagementAgent Litware -DN 'CN=HoofHearted,OU=IceMelted,DC=Litware,DC=ca'

.EXAMPLE

Get a CS object by metaverse object GUID.
This is a neat example because while there no MV equivalent of the MIIS_CSObject WMI class, you can pass an MV GUID to get all of the CS objects joined to an MV object. This example will return multiple objects if the MV object is joined to multiple CS objects.
Get-MIIS_CSObject -MVGuid 45556324-9a22-446e-8adb-65b29eb60943 -Verbose

Last edited Aug 14, 2012 at 3:29 AM by CraigMartin, version 3

Comments

No comments yet.