{"content":"<div></div>","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/ko-kr/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"Jonathan Gao","id":"2213767","name":"mumian","profile_url":"https://github.com/mumian"},{"display_name":"sankethka","id":"16908144","name":"sankethka","profile_url":"https://github.com/sankethka"}],"update_at":"2026. 10. 7.","updated_at_date_time":"2026-10-07T23:08:56.9988669Z"},"_path":"module/configurationmanager/get-cmuserdeviceaffinity.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/get-cmuserdeviceaffinity?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","description":"디바이스와 기본 사용자 간의 관계를 가져옵니다.","document_id":"3b2ceecb-7b98-819f-fe50-24fe8c5cdc1b","document_version_independent_id":"8aaf33f9-7bcb-e822-2b13-3882d0a8a6b0","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"7148a594d71d791149e9a7319d36a1216c9cf387","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/7148a594d71d791149e9a7319d36a1216c9cf387/sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md","github_contributors":["aczechowski","damabe","mumian","sankethka"],"locale":"ko-kr","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"12/14/2021","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Get-CMUserDeviceAffinity","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-10-07 11:08 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmuserdeviceaffinity","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMUserDeviceAffinity","schemaType":"PowershellCmdlet","summary":"<p>디바이스와 기본 사용자 간의 관계를 가져옵니다.</p>\n","uid":"ConfigurationManager.Get-CMUserDeviceAffinity"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Get-CMUserDeviceAffinity":{"href":"get-cmuserdeviceaffinity","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMUserDeviceAffinity","schemaType":"PowershellCmdlet","summary":"<p>디바이스와 기본 사용자 간의 관계를 가져옵니다.</p>\n","uid":"ConfigurationManager.Get-CMUserDeviceAffinity"}},"description":"<p>\n              <strong>Get-CMUserDeviceAffinity</strong> cmdlet은 Configuration Manager에서 하나 이상의 사용자 디바이스 선호도를 가져옵니다. 사용자 디바이스 친화성은 디바이스와 기본 사용자 간의 관계입니다. 자세한 내용은 <a href=\"/mem/configmgr/apps/deploy-use/link-users-and-devices-with-user-device-affinity\">Configuration Manager에서 사용자 디바이스 선호도를 사용하여 사용자 및 디바이스 연결을 참조하세요</a>.</p>\n<div class=\"NOTE\">\n<p>참고</p>\n<p>Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: <code>PS XYZ:\\&gt;</code>). 자세한 내용은 <a href=\"/powershell/sccm/overview\">시작을 참조하세요</a>.</p>\n</div>\n","examples":[{"code":"Get-CMUserDeviceAffinity -UserName \"contoso\\jqpublic\"","description":"","summary":"<p>이 명령은 <strong>contoso\\jqpublic</strong> 사용자에 대한 모든 사용자 디바이스 친화성을 가져옵니다.</p>\n","title":"예제 1: 사용자 이름으로 사용자 디바이스 친화성 가져오기"},{"code":"PS XYZ:\\> $user = \"contoso\\jqpublic\"\nPS XYZ:\\> Get-CMUserDeviceAffinity -UserName $user | Select-Object ResourceName\nResourceName\n------------\nPUYALLUP01\nKULSHAN02\nTAHOMA42","description":"","summary":"<p>이 예제는 첫 번째 예제와 비슷하지만 <strong>Select-Object</strong> cmdlet을 사용하여 반환된 특성 목록을 줄입니다. 이 예제를 사용하여 특정 사용자가 정기적으로 사용하는 디바이스를 빠르게 찾을 수 있습니다. 이 예제에서는 이 수정된 형식의 출력을 보여줍니다.</p>\n","title":"예제 2: 지정된 사용자에 대한 디바이스 가져오기"},{"code":"Get-CMUserDeviceAffinity -UserID \"2063597981\"","description":"","summary":"<p>이 명령은 리소스 ID가 <strong>2063597981</strong> 사용자에 대한 모든 사용자 디바이스 친화성을 가져옵니다.</p>\n","title":"예제 3: 사용자 ID별로 사용자 디바이스 친화성 가져오기"},{"code":"Get-CMUserDeviceAffinity -DeviceName \"CMCEN-DIST02\"","description":"","summary":"<p>이 명령은 <strong>CMCEN-DIST02</strong>라는 디바이스에 대한 사용자 디바이스 선호도를 가져옵니다.</p>\n","title":"예제 4: 디바이스 이름에 대한 사용자 디바이스 선호도 가져오기"},{"code":"Get-CMUserDeviceAffinity -DeviceID \"16780642\"","description":"","summary":"<p>이 명령은 리소스 ID가 <strong>16780642</strong> 디바이스에 대한 사용자 디바이스 선호도를 가져옵니다.</p>\n","title":"예제 5: 디바이스 ID에 대한 사용자 디바이스 선호도 가져오기"},{"code":"$computers = Import-Csv -Path \"C:\\Users\\jqpublic\\computers.csv\"\r\n\r\nforeach ( $computer in $computers )\r\n{\r\n  $uda = Get-CMUserDeviceAffinity -DeviceName $computer.Name\r\n  \r\n  if ( ($uda.UniqueUserName).count -gt 1 )\r\n  {\r\n    foreach ( $user in $uda.UniqueUserName )\r\n    {\r\n      Write-Host $uda.ResourceName[1] $user\r\n    }\r\n  }\r\n  else\r\n  {\r\n    write-host $uda.ResourceName $uda.UniqueUserName\r\n  }\r\n}","description":"<p>스크립트 샘플에서는 Import-Csv cmdlet을 사용하여 디바이스 이름에 대한 <strong>이름</strong> 열이 있는 쉼표로 구분된 목록에서 입력을 가져옵니다.</p>\n<ul>\n<li>첫 번째 <code>foreach</code> 명령은 쉼표로 구분된 파일에서 각 줄을 반복합니다. \n              <strong>Get-CMUserDeviceAffinity</strong> cmdlet을 사용하여 해당 디바이스의 기본 사용자를 가져옵니다.</li>\n<li>디바이스의 기본 사용자가 두 명 이상 있는 경우 컴퓨터 이름과 각 사용자를 별도의 줄에 씁니다.</li>\n<li>디바이스의 기본 사용자가 하나만 있는 경우 컴퓨터 이름과 사용자를 씁니다.</li>\n<li>스크립트의 출력은 컴퓨터 이름과 연결된 기본 사용자 이름의 간단한 목록입니다.</li>\n</ul>\n","summary":"<p>이 스크립트 샘플은 가져온 디바이스 목록에 대한 기본 사용자를 표시합니다. 이 목록을 가져오는 한 가지 방법은 Configuration Manager 콘솔의 <strong>디바이스</strong> 노드에서 여러 행을 다중 선택하고 텍스트(<strong>Ctrl</strong><strong>V</strong>)를  +  복사하는 것입니다. 데이터를 일반 텍스트 파일에 붙여넣고 탭 문자를 쉼표(<code>,</code>)로 바꾼 다음 <strong>computers.csv</strong>로 저장합니다.</p>\n","title":"예제 6: 디바이스 목록에 대한 기본 사용자 가져오기"}],"inputs":[{"description":"","name":"<span class=\"no-loc xref\">None</span>\n"}],"links":[{"href":"approve-cmuserdeviceaffinityrequest","text":"Approve-CMUserDeviceAffinityRequest"},{"href":"deny-cmuserdeviceaffinityrequest","text":"Deny-CMUserDeviceAffinityRequest"},{"href":"get-cmuserdeviceaffinityrequest","text":"Get-CMUserDeviceAffinityRequest"},{"href":"import-cmuserdeviceaffinity","text":"Import-CMUserDeviceAffinity"},{"href":"/mem/configmgr/apps/deploy-use/link-users-and-devices-with-user-device-affinity","text":"Configuration Manager에서 사용자 및 디바이스를 사용자 디바이스 선호도와 연결"}],"module":"ConfigurationManager","name":"Get-CMUserDeviceAffinity","notes":"<p>이 반환 개체 및 해당 속성에 대한 자세한 내용은 <a href=\"/mem/configmgr/develop/reference/core/clients/manage/sms_usermachinerelationship-server-wmi-class\">SMS_UserMachineRelationship 서버 WMI 클래스</a>를 참조하세요.</p>\n","outputs":[{"description":"","name":"<span class=\"no-loc xref\">IResultObject[]</span>\n"},{"description":"","name":"<span class=\"no-loc xref\">IResultObject</span>\n"}],"parameters":[{"aliases":"ResourceId","defaultValue":"None","description":"<p>기본 사용자를 가져올 디바이스 리소스 ID 배열을 지정합니다.</p>\n","isRequired":true,"name":"DeviceId","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Int32</span><span>[</span><span>]</span></p>\n"},{"acceptWildcardCharacters":true,"aliases":"ResourceName","defaultValue":"None","description":"<p>디바이스 이름 배열을 지정합니다.</p>\n","isRequired":true,"name":"DeviceName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"},{"aliases":"","defaultValue":"None","description":"<p>이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. \n              <strong>ForceWildcardHandling</strong>과 결합할 수 없습니다.</p>\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. \n              <strong>DisableWildcardHandling</strong>과 결합할 수 없습니다.</p>\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>이 매개 변수를 추가하여 승인되지 않은 친화성을 필터링합니다.</p>\n","name":"ShowApprovedOnly","parameterValueGroup":"","position":"Named","type":"<span class=\"no-loc xref\">SwitchParameter</span>\n"},{"aliases":"","defaultValue":"None","description":"<p>사용자 리소스 ID의 배열을 지정합니다. 이 매개 변수를 사용하여 이 사용자가 기본 사용자인 모든 디바이스를 가져옵니다.</p>\n","isRequired":true,"name":"UserId","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">Int32</span><span>[</span><span>]</span></p>\n"},{"acceptWildcardCharacters":true,"aliases":"UniqueUserName","defaultValue":"None","description":"<p>사용자 이름 배열을 지정합니다. 이 매개 변수를 사용하여 이 사용자가 기본 사용자인 모든 디바이스를 가져옵니다.</p>\n","isRequired":true,"name":"UserName","parameterValueGroup":"","position":"Named","type":"<p><span class=\"no-loc xref\">String</span><span>[</span><span>]</span></p>\n"}],"schema":"PowershellCmdlet","summary":"<p>디바이스와 기본 사용자 간의 관계를 가져옵니다.</p>\n","syntaxes":["Get-CMUserDeviceAffinity -UserName <String[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]","Get-CMUserDeviceAffinity -DeviceId <Int32[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]","Get-CMUserDeviceAffinity -DeviceName <String[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]","Get-CMUserDeviceAffinity -UserId <Int32[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]"],"uid":"ConfigurationManager.Get-CMUserDeviceAffinity","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"ko-kr","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmuserdeviceaffinity","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMUserDeviceAffinity","schemaType":"PowershellCmdlet","summary":"<p>디바이스와 기본 사용자 간의 관계를 가져옵니다.</p>\n","uid":"ConfigurationManager.Get-CMUserDeviceAffinity"}],"canonical_url":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/get-cmuserdeviceaffinity?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ko-kr/powershell/module/configurationmanager/get-cmuserdeviceaffinity?view=sccm-ps"},"pageMetadata":"<meta name=\"description\" content=\"<p>\n              <strong>Get-CMUserDeviceAffinity</strong> cmdlet은 Configuration Manager에서 하나 이상의 사용자 디바이스 선호도를 가져옵니다. 사용자 디바이스 친화성은 디바이스와 기본 사용자 간의 관계입니다. 자세한 내용은 <a href=&quot;/mem/configmgr/apps/deploy-use/link-users-and-devices-with-user-device-affinity&quot;>Configuration Manager에서 사용자 디바이스 선호도를 사용하여 사용자 및 디바이스 연결을 참조하세요</a>.</p>\n<div class=&quot;NOTE&quot;>\n<p>참고</p>\n<p>Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: <code>PS XYZ:\\&amp;gt;</code>). 자세한 내용은 <a href=&quot;/powershell/sccm/overview&quot;>시작을 참조하세요</a>.</p>\n</div>\n\" />\r\n<meta name=\"hideEdit\" content=\"true\" />\r\n<meta name=\"loc_file_id\" content=\"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Get-CMUserDeviceAffinity.md\" />\r\n<meta name=\"loc_source_id\" content=\"Github-72476255#live\" />\r\n<meta name=\"loc_version\" content=\"2024-08-21T21:18:36.7205003Z\" />\r\n<meta name=\"module\" content=\"ConfigurationManager\" />\r\n<meta name=\"ms.contentlocale\" content=\"ko-kr\" />\r\n<meta name=\"ms.translationtype\" content=\"MT\" />\r\n<meta name=\"name\" content=\"Get-CMUserDeviceAffinity\" />\r\n<meta name=\"notes\" content=\"<p>이 반환 개체 및 해당 속성에 대한 자세한 내용은 <a href=&quot;/mem/configmgr/develop/reference/core/clients/manage/sms_usermachinerelationship-server-wmi-class&quot;>SMS_UserMachineRelationship 서버 WMI 클래스</a>를 참조하세요.</p>\n\" />\r\n<meta name=\"schema\" content=\"PowershellCmdlet\" />\r\n<meta name=\"summary\" content=\"<p>디바이스와 기본 사용자 간의 관계를 가져옵니다.</p>\n\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMUserDeviceAffinity -UserName <String[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMUserDeviceAffinity -DeviceId <Int32[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMUserDeviceAffinity -DeviceName <String[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"syntaxes\" content=\"Get-CMUserDeviceAffinity -UserId <Int32[]> [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] [<CommonParameters>]\" />\r\n<meta name=\"uid\" content=\"ConfigurationManager.Get-CMUserDeviceAffinity\" />\r\n","themesRelativePathToOutputRoot":"_themes/"}