Get-CMComputerAssociation

Get-CMComputerAssociation

Gets Configuration Manager computer associations.

Syntax

Parameter Set: SearchByName
Get-CMComputerAssociation [-DestinationComputer <String> ] [-SourceComputer <String> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMComputerAssociation -MigrationId <String> [ <CommonParameters>]

Detailed Description

The Get-CMComputerAssociation cmdlet gets computer associations. Microsoft System Center 2012 SP1 Configuration Manager uses a computer association to migrate user state and settings as part of operating system deployment. You can specify a source computer, a destination computer, or both. You can also use an ID to specify a computer association.

Parameters

-DestinationComputer<String>

Specifies the name of a destination computer.

Aliases

RestoreName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-MigrationId<String>

Specifies the ID of a computer association.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SourceComputer<String>

Specifies the name of a source computer.

Aliases

SourceName

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Get all computer associations

This command gets all the computer associations for System Center 2012 Configuration Manager.

PS C:\> Get-CMComputerAssociation

Example 2: Get computer associations for a destination comptuter

This command gets all the computer associations for the destination computer named West155.

PS C:\> Get-CMComputerAssociation -DestinationComputer "West155"

Example 3: Get a computer association by using an ID

This command gets the computer association that has the ID MID1207.

PS C:\> Get-CMComputerAssociation -MigrationId "MID1207"

New-CMComputerAssociation

Remove-CMComputerAssociation

Set-CMComputerAssociation