# Get-CSObject

## Synopsis

Gets one or more connector space objects

## Syntax

```
Get-CSObject [-ID] <Guid> [-MA] <string> [<CommonParameters>]

Get-CSObject [-DN] <String> [[-IncludeSubTree] <SwitchParameter>] [-MA] <Object> [<CommonParameters>]

Get-CSObject [-Rdn] <String> [-MA] <string> [<CommonParameters>]
```

## Description

The [Get-CSObject](https://docs.lithnet.io/mim-sync-service/usage/cmdlet-reference/get-csobject) cmdlet allows you to get one or more connector space objects using the connector space object's ID, its DN, or RDN

## Parameters

#### -MA \<string>

The management agent to get the connector space object from

|                             |       |
| --------------------------- | ----- |
| Required?                   | true  |
| Position?                   | 1     |
| Default value               |       |
| Accept pipeline input?      | false |
| Accept wildcard characters? | false |

#### -ID \<Guid>

The connector space object ID

|                             |       |
| --------------------------- | ----- |
| Required?                   | true  |
| Position?                   | 1     |
| Default value               |       |
| Accept pipeline input?      | false |
| Accept wildcard characters? | false |

#### -DN \<string>

The distinguished name of the connector space object

|                             |       |
| --------------------------- | ----- |
| Required?                   | true  |
| Position?                   | 1     |
| Default value               |       |
| Accept pipeline input?      | false |
| Accept wildcard characters? | false |

#### -Rdn \<string>

The relative distinguished name of the connector space object

|                             |       |
| --------------------------- | ----- |
| Required?                   | true  |
| Position?                   | 1     |
| Default value               |       |
| Accept pipeline input?      | false |
| Accept wildcard characters? | false |

#### -IncludeSubTree \<SwitchParameter>

Specifies that all objects contained below the specified DN should be returned

|                             |       |
| --------------------------- | ----- |
| Required?                   | false |
| Position?                   | 1     |
| Default value               |       |
| Accept pipeline input?      | false |
| Accept wildcard characters? | false |

#### \<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see [about CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## Examples

### Get an object by its known ID

```
PS C:\> Get-CSObject -ID 82BFCE95-0DE6-4537-85B0-6DFD360313A1 -MA ADMA
```

### Get an object by its DN

```
PS C:\> Get-CSObject -DN "CN=John Smith, OU=Sales, DC=contoso, DC=local" -MA ADMA
```

### Get all objects in the sales OU

```
PS C:\> Get-CSObject -DN "OU=Sales, DC=contoso, DC=local" -IncludeSubTree -MA ADMA
```

### Get an object by its RDN

```
PS C:\> Get-CSObject -RDN "CN=John Smith" -MA ADMA
```