다음을 통해 공유

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

Description

Get-CMUserDeviceAffinity cmdlet은 Configuration Manager에서 하나 이상의 사용자 디바이스 선호도를 가져옵니다. 사용자 디바이스 친화성은 디바이스와 기본 사용자 간의 관계입니다. 자세한 내용은 Configuration Manager에서 사용자 디바이스 선호도를 사용하여 사용자 및 디바이스 연결을 참조하세요.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 사용자 이름으로 사용자 디바이스 친화성 가져오기

이 명령은 contoso\jqpublic 사용자에 대한 모든 사용자 디바이스 친화성을 가져옵니다.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

예제 2: 지정된 사용자에 대한 디바이스 가져오기

이 예제는 첫 번째 예제와 비슷하지만 Select-Object cmdlet을 사용하여 반환된 특성 목록을 줄입니다. 이 예제를 사용하여 특정 사용자가 정기적으로 사용하는 디바이스를 빠르게 찾을 수 있습니다. 이 예제에서는 이 수정된 형식의 출력을 보여줍니다.

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: 디바이스 목록에 대한 기본 사용자 가져오기

이 스크립트 샘플은 가져온 디바이스 목록에 대한 기본 사용자를 표시합니다. 이 목록을 가져오는 한 가지 방법은 Configuration Manager 콘솔의 디바이스 노드에서 여러 행을 다중 선택하고 텍스트(CtrlV)를 + 복사하는 것입니다. 데이터를 일반 텍스트 파일에 붙여넣고 탭 문자를 쉼표(,)로 바꾼 다음 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 cmdlet을 사용하여 디바이스 이름에 대한 이름 열이 있는 쉼표로 구분된 목록에서 입력을 가져옵니다.

  • 첫 번째 foreach 명령은 쉼표로 구분된 파일에서 각 줄을 반복합니다. Get-CMUserDeviceAffinity cmdlet을 사용하여 해당 디바이스의 기본 사용자를 가져옵니다.
  • 디바이스의 기본 사용자가 두 명 이상 있는 경우 컴퓨터 이름과 각 사용자를 별도의 줄에 씁니다.
  • 디바이스의 기본 사용자가 하나만 있는 경우 컴퓨터 이름과 사용자를 씁니다.
  • 스크립트의 출력은 컴퓨터 이름과 연결된 기본 사용자 이름의 간단한 목록입니다.

매개 변수

-DeviceId

기본 사용자를 가져올 디바이스 리소스 ID 배열을 지정합니다.

형식:Int32[]
별칭:ResourceId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DeviceName

디바이스 이름 배열을 지정합니다.

형식:String[]
별칭:ResourceName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ShowApprovedOnly

이 매개 변수를 추가하여 승인되지 않은 친화성을 필터링합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserId

사용자 리소스 ID의 배열을 지정합니다. 이 매개 변수를 사용하여 이 사용자가 기본 사용자인 모든 디바이스를 가져옵니다.

형식:Int32[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserName

사용자 이름 배열을 지정합니다. 이 매개 변수를 사용하여 이 사용자가 기본 사용자인 모든 디바이스를 가져옵니다.

형식:String[]
별칭:UniqueUserName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:True

입력

None

출력

IResultObject[]

IResultObject

참고

이 반환 개체 및 해당 속성에 대한 자세한 내용은 SMS_UserMachineRelationship 서버 WMI 클래스를 참조하세요.