{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-cn/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/6/25","updated_at_date_time":"2026-06-25T23:12:26.2151991Z"},"_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/zh-cn/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":"zh-cn","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-06-25 11:12 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/get-cmuserdeviceaffinity","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Get-CMUserDeviceAffinity","schemaType":"PowershellCmdlet","summary":"

获取设备与其主要用户之间的关系。

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

获取设备与其主要用户之间的关系。

\n","uid":"ConfigurationManager.Get-CMUserDeviceAffinity"}},"description":"

\n Get-CMUserDeviceAffinity cmdlet 在 Configuration Manager 中获取一个或多个用户设备相关性。 用户设备相关性是设备与其主要用户之间的关系。 有关详细信息，请参阅 在 Configuration Manager 中使用用户设备相关性链接用户和设备。

\n
\n

注意

\n

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\\>。 有关详细信息，请参阅 入门。

\n
\n","examples":[{"code":"Get-CMUserDeviceAffinity -UserName \"contoso\\jqpublic\"","description":"","summary":"

此命令获取用户 contoso\\jqpublic 的任何用户设备相关性。

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

此示例与第一个示例类似，但使用 Select-Object cmdlet 减少了返回的属性列表。 可以使用此示例快速查找特定用户经常使用的设备。 此示例以此修改后的格式显示输出。

\n","title":"示例 2：获取给定用户的设备"},{"code":"Get-CMUserDeviceAffinity -UserID \"2063597981\"","description":"","summary":"

此命令获取资源 ID 为2063597981的用户的任何用户设备相关性。

\n","title":"示例 3：按用户 ID 获取用户设备相关性"},{"code":"Get-CMUserDeviceAffinity -DeviceName \"CMCEN-DIST02\"","description":"","summary":"

此命令获取名为 CMCEN-DIST02 的设备的用户设备相关性。

\n","title":"示例 4：获取设备名称的用户设备相关性"},{"code":"Get-CMUserDeviceAffinity -DeviceID \"16780642\"","description":"","summary":"

此命令获取具有资源 ID 16780642的设备的用户设备相关性。

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

脚本示例使用 Import-Csv cmdlet 从以逗号分隔的列表获取输入，该列表具有设备名称的 “名称” 列。

\n\n","summary":"

此脚本示例显示导入的设备列表的主要用户。 获取此列表的一种方法是从 Configuration Manager 控制台的 “设备” 节点中，多选多个行，然后 (Ctrl + V) 复制文本。 将数据粘贴到纯文本文件中，将制表符替换为逗号 (,) ，然后将其另存为 computers.csv。

\n","title":"示例 6：获取设备列表的主要用户"}],"inputs":[{"description":"","name":"None\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":"

有关此返回对象及其属性的详细信息，请参阅 SMS_UserMachineRelationship服务器 WMI 类。

\n","outputs":[{"description":"","name":"IResultObject[]\n"},{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"ResourceId","defaultValue":"None","description":"

指定设备资源 ID 的数组以获取其主要用户。

\n","isRequired":true,"name":"DeviceId","parameterValueGroup":"","position":"Named","type":"

Int32[]

\n"},{"acceptWildcardCharacters":true,"aliases":"ResourceName","defaultValue":"None","description":"

指定设备名称数组。

\n","isRequired":true,"name":"DeviceName","parameterValueGroup":"","position":"Named","type":"

String[]

\n"},{"aliases":"","defaultValue":"None","description":"

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

添加此参数以筛选出未批准的相关性。

\n","name":"ShowApprovedOnly","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

指定用户资源 ID 的数组。 使用此参数可获取此用户是主要用户的任何设备。

\n","isRequired":true,"name":"UserId","parameterValueGroup":"","position":"Named","type":"

Int32[]

\n"},{"acceptWildcardCharacters":true,"aliases":"UniqueUserName","defaultValue":"None","description":"

指定用户名数组。 使用此参数可获取此用户是主要用户的任何设备。

\n","isRequired":true,"name":"UserName","parameterValueGroup":"","position":"Named","type":"

String[]

\n"}],"schema":"PowershellCmdlet","summary":"

获取设备与其主要用户之间的关系。

\n","syntaxes":["Get-CMUserDeviceAffinity -UserName [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []","Get-CMUserDeviceAffinity -DeviceId [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []","Get-CMUserDeviceAffinity -DeviceName [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []","Get-CMUserDeviceAffinity -UserId [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []"],"uid":"ConfigurationManager.Get-CMUserDeviceAffinity","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"zh-cn","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":"

获取设备与其主要用户之间的关系。

\n","uid":"ConfigurationManager.Get-CMUserDeviceAffinity"}],"canonical_url":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/get-cmuserdeviceaffinity?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/get-cmuserdeviceaffinity?view=sccm-ps"},"pageMetadata":"\n Get-CMUserDeviceAffinity cmdlet 在 Configuration Manager 中获取一个或多个用户设备相关性。 用户设备相关性是设备与其主要用户之间的关系。 有关详细信息，请参阅 在 Configuration Manager 中使用用户设备相关性链接用户和设备。

\n
\n

注意

\n

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\\>。 有关详细信息，请参阅 入门。

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n有关此返回对象及其属性的详细信息，请参阅 SMS_UserMachineRelationship服务器 WMI 类。

\n\" />\r\n\r\n获取设备与其主要用户之间的关系。

\n\" />\r\n [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []\" />\r\n [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []\" />\r\n [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []\" />\r\n [-ShowApprovedOnly] [-DisableWildcardHandling]\n [-ForceWildcardHandling] []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}