.png)
Remove-CMAccount
Updated: March 1, 2013
Applies To: System Center 2012 Configuration Manager SP1
Remove-CMAccount
Syntax
Parameter Set: SearchByNameMandatory Remove-CMAccount -Name <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>] Parameter Set: SearchByValueMandatory Remove-CMAccount -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMAccount cmdlet removes a user account from Microsoft System Center 2012 Configuration Manager. System Center 2012 Configuration Manager uses user accounts to connect to various system and network resources. For more information about user accounts, see Technical Reference for Accounts Used in Configuration Manager in the TechNet Library at http://go.microsoft.com/fwlink/?LinkID=248317.
Parameters
-Force
Indicates that the user account is always removed.
Aliases | none |
Required? | false |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-InputObject<IResultObject>
Specifies a user account object. You can get a user account object by using the Get-CMAccount cmdlet.
Aliases | none |
Required? | true |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-Name<String>
Specifies the name of the user account.
Aliases | UserName |
Required? | true |
Position? | named |
Default Value | none |
Accept Pipeline Input? | True (ByPropertyName) |
Accept Wildcard Characters? | false |
-Confirm
Prompts you for confirmation before executing the command.
Required? | false |
Position? | named |
Default Value | false |
Accept Pipeline Input? | false |
Accept Wildcard Characters? | false |
-WhatIf
Describes what would happen if you executed the command without actually executing the command.
Required? | false |
Position? | named |
Default Value | false |
Accept Pipeline Input? | false |
Accept Wildcard Characters? | false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Remove a user account by using its name
This command removes the user account that is specified by its name.
PS C:\> Remove-CMAccount –Name "CONTOSO\MDempsey"
