Freigeben über

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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

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

Typ:IResultObject
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Benutzerkontos an.

Typ:String
Aliase:UserName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-ResourceId

Gibt die Ressourcen-ID eines Benutzerkontos an.

Typ:Int32
Aliase:Id, UserId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object