Get-CMUserDeviceAffinity
Get-CMUserDeviceAffinity
Gets user device affinities.
構文
Parameter Set: SearchByDeviceIdMandatory
Get-CMUserDeviceAffinity -DeviceId <String[]> [ <CommonParameters>]
Parameter Set: SearchByDeviceNameMandatory
Get-CMUserDeviceAffinity -DeviceName <String[]> [ <CommonParameters>]
Parameter Set: SearchByUserIdMandatory
Get-CMUserDeviceAffinity -UserId <String[]> [ <CommonParameters>]
Parameter Set: SearchByUserNameMandatory
Get-CMUserDeviceAffinity -UserName <String[]> [ <CommonParameters>]
詳細説明
The Get-CMUserDeviceAffinity cmdlet gets one or more user device affinities. User device affinity in Microsoft System Center 2012 Configuration Manager is a method of associating a user with one or more specified devices.
パラメーター
-DeviceId<String[]>
Specifies an array of device IDs.
エイリアス |
ResourceId |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-DeviceName<String[]>
Specifies an array of device names.
エイリアス |
ResourceName |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserId<String[]>
Specifies an array of IDs of the primary users of the devices.
エイリアス |
なし |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
-UserName<String[]>
Specifies an array of names of the primary users of the devices.
エイリアス |
UniqueUserName |
必須? |
true |
位置は? |
named |
既定値 |
なし |
パイプライン入力を許可する |
True (ByPropertyName) |
ワイルドカード文字を許可する |
false |
<CommonParameters>
このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。
入力
入力型は、コマンドレットにパイプできるオブジェクトの型です。
出力
出力型は、コマンドレットによって生成されるオブジェクトの型です。
例
Example 1: Get a user device affinity by using a user name
This command gets the user device affinity for the user named CENTRAL\001D$.
PS C:\> Get-CMUserDeviceAffinity -UserName "CENTRAL\001D$"
Example 2: Get a user device affinity by using a user ID
This command gets the user device affinity for the user that has the ID named 2063597981.
PS C:\> Get-CMUserDeviceAffinity -UserID "2063597981"
Example 3: Get a user device affinity by using a device name
This command gets the user device affinity for the device named CMCEN-DIST02.
PS C:\> Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"
Example 4: Get a user device affinity by using a device ID
This command gets the user device affinity for the device that has the ID 2097152000.
PS C:\> Get-CMUserDeviceAffinity -DeviceID "2097152000"
関連トピック
Get-CMUserDeviceAffinityRequest