Get-CMUserDeviceAffinityRequest

Get-CMUserDeviceAffinityRequest

Gets a request for user device affinity in Configuration Manager.

Syntax

Parameter Set: SearchByNameMandatory
Get-CMUserDeviceAffinityRequest -CollectionName <String> [-DeviceId <String> ] [-DeviceName <String> ] [-UserId <String> ] [-UserName <String> ] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Get-CMUserDeviceAffinityRequest -CollectionId <String> [-DeviceId <String> ] [-DeviceName <String> ] [-UserId <String> ] [-UserName <String> ] [ <CommonParameters>]

Detailed Description

The Get-CMUserDeviceAffinityRequest cmdlet gets a request for user device affinity.

In Microsoft System Center 2012 SP1 Configuration Manager, user device affinity defines a relationship between a user and a device. Instead of deploying an application to a group of devices, you deploy an application to a user and Configuration Manager installs the application on all devices associated with the user.

Parameters

-CollectionId<String>

Specifies a collection ID that represents the user device affinity in Configuration Manager.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-CollectionName<String>

Specifies a name of a collection that represents the user device affinity in Configuration Manager.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceId<String>

Specifies a device ID in Configuration Manager.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DeviceName<String>

Specifies a device name in Configuration Manager.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserId<String>

Specifies a Configuration Manager ID for a user resource.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-UserName<String>

Specifies a user name for a resource in Configuration Manager.

Aliases

none

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 a request for user device affinity

This command gets a request for user device affinity for the collection named All Systems.

PS C:\> Get-CMUserDeviceAffinityRequest -CollectionName "All Systems"

Approve-CMUserDeviceAffinityRequest

Deny-CMUserDeviceAffinityRequest