Remove-CMUser

  • Referenz
Modul:
ConfigurationManager

Entfernt einen Benutzer aus Configuration Manager.

Syntax

Remove-CMUser
      [-Force]
      [-InputObject] <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUser
      [-Force]
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMUser
      [-Force]
      [-ResourceId] <Int32>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMUser entfernt Benutzerkonten aus Configuration Manager.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen eines Benutzers

PS XYZ:\> $User = Get-CMUser -CollectionName "All Users" -Name "Contoso\user01"
PS XYZ:\> Remove-CMUser -InputObject $User -Force

Der erste Befehl ruft das Benutzerobjekt mit dem Namen user01 aus der All Users-Auflistung ab und speichert das Objekt in der variablen $User.

Mit dem zweiten Befehl wird das in $User gespeicherte Benutzerkonto entfernt. Die Angabe des Force-Parameters gibt an, dass der Benutzer nicht aufgefordert wird, bevor das Benutzerkonto entfernt wird.

Beispiel 2: Entfernen eines Benutzers mithilfe der Pipeline

PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\user02" | Remove-CMUser -Force

Dieser Befehl ruft das Benutzerobjekt mit dem Namen user02 aus der All Users-Auflistung ab und verwendet den Pipelineoperator, um das Objekt an Remove-CMUser zu übergeben, wodurch das Benutzerkonto entfernt wird. Die Angabe des Force-Parameters gibt an, dass der Benutzer nicht aufgefordert wird, bevor das Benutzerkonto entfernt wird.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

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

-InputObject

Gibt ein Configuration Manager Benutzerkontoobjekt an. Verwenden Sie das Cmdlet Get-CMUser, um ein Configuration Manager Benutzerkontoobjekt abzurufen.

Type:IResultObject
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt den Namen eines Benutzerkontos an.

Type:String
Aliases:UserName
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-ResourceId

Gibt die Ressourcen-ID eines Benutzerkontos an.

Type:Int32
Aliases:Id, UserId
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object