description | external help file | Module Name | ms.date | schema | title |
---|---|---|---|---|---|
Removes a primary user from one or more devices in the Configuration Manager hierarchy. |
AdminUI.PS.dll-Help.xml |
ConfigurationManager |
05/07/2019 |
2.0.0 |
Remove-CMUserAffinityFromDevice |
Removes a primary user from one or more devices in the Configuration Manager hierarchy.
Remove-CMUserAffinityFromDevice -DeviceName <String[]> [-Force] [-UserId <Int32[]>] [-UserName <String[]>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
Remove-CMUserAffinityFromDevice -DeviceId <Int32[]> [-Force] [-UserId <Int32[]>] [-UserName <String[]>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
The Remove-CMUserAffinityFromDevice cmdlet removes a primary user from the devices.
User device affinity is a method of associating a user with one or more specified devices in Configuration Manager.
Note
Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>
. For more information, see getting started.
PS XYZ:\> Remove-CMUserAffinityFromDevice -DeviceId "209846738" -UserId "206359374"
This command removes the association between the user that has the ID 206359374 and the device that has the ID 209846738.
Specifies an array of IDs of the devices.
Type: Int32[]
Parameter Sets: RemoveUserAffinityByDeviceId
Aliases: ResourceId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies an array of names of the devices.
Type: String[]
Parameter Sets: RemoveUserAffinityByDeviceName
Aliases: ResourceName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Forces the command to run without asking for user confirmation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the ID of a user.
Type: Int32[]
Parameter Sets: (All)
Aliases: UserIds
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the name of the primary user that you want to disassociate from the specified devices.
Type: String[]
Parameter Sets: (All)
Aliases: UserNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Shows what would happen if the cmdlet runs. The cmdlet doesn't run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.