Add-CMUserAffinityToDevice

  • 参考
模块:
ConfigurationManager

将主用户添加到Configuration Manager层次结构中的一个或多个设备。

语法

Add-CMUserAffinityToDevice
   -DeviceName <String[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMUserAffinityToDevice
   -DeviceId <Int32[]>
   [-UserId <Int32[]>]
   [-UserName <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Add-CMUserAffinityToDevice cmdlet 将设备与 Configuration Manager 中的主用户相关联。 可以指定要通过主要用户的名称或 ID 与主要用户关联的设备。 可以按主用户的名称或 ID 指定主用户。

用户设备相关性是一种将用户与一个或多个指定设备相关联的方法。 这使你可以将应用程序部署到用户，而无需知道所有用户设备的名称。 将应用程序部署到用户，应用程序会自动安装在与该用户关联的所有设备上，而不是将应用程序部署到用户的所有设备。

注意

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

示例

示例 1：将主用户添加到设备

PS XYZ:\>Add-CMUserAffinityToDevice -DeviceName "CMCEN-DIST-02" -UserId "2063597981"

此命令将 ID 2063597981的主用户添加到名为 CMCEN-DIST-02 的设备。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DeviceId

指定要与主用户关联的设备的 ID 数组。

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

-DeviceName

指定要与主用户关联的设备名称的数组。

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-UserId

指定用户的 ID。

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

-UserName

指定主要用户的名称。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

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

输入

None

输出

System.Object