Get-CMUserDeviceAffinity

  • リファレンス
モジュール:
ConfigurationManager

デバイスとそのプライマリ ユーザー間の関係を取得します。

構文

Get-CMUserDeviceAffinity
   -UserName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -DeviceName <String[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMUserDeviceAffinity
   -UserId <Int32[]>
   [-ShowApprovedOnly]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

説明

Get-CMUserDeviceAffinity コマンドレットは、Configuration Manager で 1 つ以上のユーザー デバイスアフィニティを取得します。 ユーザー デバイスアフィニティは、デバイスとプライマリ ユーザーの関係です。 詳細については、「Configuration Manager でのユーザーとデバイスのアフィニティを使用してユーザーとデバイスをリンク する」を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: ユーザー名でユーザー デバイスのアフィニティを取得する

このコマンドは、ユーザー contoso\jqpublicに対するユーザー デバイスアフィニティを取得します。

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

例 2: 特定のユーザーのデバイスを取得する

この例は、最初の例と似ていますが 、Select-Object コマンドレットを使用して返される属性の一覧を減らします。 この例を使用すると、特定のユーザーが定期的に使用するデバイスをすばやく検索できます。 次の使用例は、この変更された形式の出力を示しています。

PS XYZ:\> $user = "contoso\jqpublic"
PS XYZ:\> Get-CMUserDeviceAffinity -UserName $user | Select-Object ResourceName
ResourceName
------------
PUYALLUP01
KULSHAN02
TAHOMA42

例 3: ユーザー ID によるユーザー デバイスアフィニティの取得

このコマンドは、リソース ID を持つユーザーのデバイス アフィニティを取得2063597981。

Get-CMUserDeviceAffinity -UserID "2063597981"

例 4: デバイス名に対するユーザー デバイスアフィニティの取得

このコマンドは 、CMCEN-DIST02という名前のデバイスのユーザー デバイスアフィニティを取得します。

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

例 5: デバイス ID のユーザー デバイス アフィニティを取得する

このコマンドは、リソース ID を持つデバイスのユーザー デバイスアフィニティを取得16780642。

Get-CMUserDeviceAffinity -DeviceID "16780642"

例 6: デバイスの一覧のプライマリ ユーザーを取得する

このスクリプト サンプルは、インポートされたデバイスの一覧のプライマリ ユーザーを表示します。 この一覧を取得する方法の 1 つは、Configuration **** Manager コンソールの [デバイス] ノードで複数の行を複数選択し、テキスト (Ctrl + V) をコピーする方法です。 データをプレーン テキスト ファイルに貼り付け、タブ文字をコンマ ( ) に置き換え、次にデータとして保存 ,computers.csv。 ** **

$computers = Import-Csv -Path "C:\Users\jqpublic\computers.csv"

foreach ( $computer in $computers )
{
  $uda = Get-CMUserDeviceAffinity -DeviceName $computer.Name
  
  if ( ($uda.UniqueUserName).count -gt 1 )
  {
    foreach ( $user in $uda.UniqueUserName )
    {
      Write-Host $uda.ResourceName[1] $user
    }
  }
  else
  {
    write-host $uda.ResourceName $uda.UniqueUserName
  }
}

スクリプト サンプルでは、Import-Csv コマンドレットを使用して、デバイス名の [ 名前] 列を含むコンマ区切りリストから入力を受け取ります。

  • 最初の foreach コマンドは、コンマ区切りファイルから各行をループします。 Get-CMUserDeviceAffinityコマンドレットを使用して、そのデバイスのプライマリ ユーザーを取得します。
  • デバイスのプライマリ ユーザーが複数ある場合は、コンピューター名と各ユーザーを別の行に書き込みます。
  • デバイスのプライマリ ユーザーが 1 人しかいない場合は、コンピューター名とユーザーが書き込みます。
  • スクリプトの出力は、コンピューター名と関連付けられたプライマリ ユーザー名の簡単な一覧です。

パラメーター

-DeviceId

プライマリ ユーザーを取得するには、デバイス リソースの ID の配列を指定します。

Type:Int32[]
Aliases:ResourceId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

デバイス名の配列を指定します。

Type:String[]
Aliases:ResourceName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True
-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ShowApprovedOnly

承認されていないアフィニティをフィルター処理するには、このパラメーターを追加します。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserId

ユーザー リソース ID の配列を指定します。 このパラメーターを使用して、このユーザーがプライマリ ユーザーであるデバイスを取得します。

Type:Int32[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserName

ユーザー名の配列を指定します。 このパラメーターを使用して、このユーザーがプライマリ ユーザーであるデバイスを取得します。

Type:String[]
Aliases:UniqueUserName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

入力

None

出力

IResultObject[]

IResultObject

メモ

この戻り値オブジェクトとそのプロパティの詳細については、「SMS_UserMachineRelationship WMI クラス」を参照してください。