Get-CMUserDeviceAffinity

  • Referencia
Módulo:
ConfigurationManager

Obtenga las relaciones entre un dispositivo y sus usuarios principales.

Syntax

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

El cmdlet Get-CMUserDeviceAffinity obtiene una o varias afinidades de dispositivo de usuario en Configuration Manager. Las afinidades entre los dispositivos de usuario son las relaciones entre un dispositivo y sus usuarios principales. Para obtener más información, vea Vincular usuarios y dispositivos con afinidad de dispositivo de usuario en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de afinidades de dispositivo de usuario por nombre de usuario

Este comando obtiene las afinidades de dispositivo de usuario para el usuario contoso\jqpublic.

Get-CMUserDeviceAffinity -UserName "contoso\jqpublic"

Ejemplo 2: Obtención de dispositivos para un usuario determinado

Este ejemplo es similar al primero, pero reduce la lista devuelta de atributos con el cmdlet Select-Object . Puede usar este ejemplo para encontrar rápidamente qué dispositivos usa regularmente un usuario específico. En este ejemplo se muestra la salida en este formato modificado.

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

Ejemplo 3: Obtención de afinidades de dispositivo de usuario por identificador de usuario

Este comando obtiene las afinidades del dispositivo de usuario para el usuario con el identificador de recurso 2063597981.

Get-CMUserDeviceAffinity -UserID "2063597981"

Ejemplo 4: Obtener una afinidad de dispositivo de usuario para un nombre de dispositivo

Este comando obtiene la afinidad de dispositivo de usuario para el dispositivo denominado CMCEN-DIST02.

Get-CMUserDeviceAffinity -DeviceName "CMCEN-DIST02"

Ejemplo 5: Obtención de una afinidad de dispositivo de usuario para un identificador de dispositivo

Este comando obtiene la afinidad de dispositivo de usuario para el dispositivo con el identificador de recurso 16780642.

Get-CMUserDeviceAffinity -DeviceID "16780642"

Ejemplo 6: Obtención de usuarios principales para una lista de dispositivos

En este ejemplo de script se muestra el usuario principal de una lista importada de dispositivos. Un método para obtener esta lista es desde la consola de Configuration Manager, en el nodo Dispositivos, seleccione varias filas y copie el texto (Ctrl + V). Pegue los datos en un archivo de texto sin formato, reemplace los caracteres de tabulación como comas (,) y guárdelos como 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
  }
}

El ejemplo de script usa el cmdlet Import-Csv para tomar la entrada de una lista separada por comas que tiene una columna Name para el nombre del dispositivo.

  • El primer foreach comando recorre en bucle cada línea del archivo separado por comas. Usa el cmdlet Get-CMUserDeviceAffinity para obtener los usuarios principales de ese dispositivo.
  • Si hay más de un usuario principal del dispositivo, escribe el nombre del equipo y cada usuario en una línea independiente.
  • Si solo hay un usuario principal del dispositivo, escribe el nombre del equipo y el usuario.
  • La salida del script es una lista sencilla de nombres de equipo y nombres de usuario principal asociados.

Parámetros

-DeviceId

Especifique una matriz de identificadores de recursos de dispositivo para obtener sus usuarios principales.

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

-DeviceName

Especifique una matriz de nombres de dispositivo.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-ShowApprovedOnly

Agregue este parámetro para filtrar las afinidades no aprobadas.

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

-UserId

Especifica una matriz de identificadores de recursos de usuario. Use este parámetro para obtener los dispositivos para los que este usuario es el usuario principal.

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

-UserName

Especifique una matriz de nombres de usuario. Use este parámetro para obtener los dispositivos para los que este usuario es el usuario principal.

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

Entradas

None

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_UserMachineRelationship clase WMI de servidor.