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 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"