What does Remove-MemoryDump do?

Remove-MemoryDump deletes a specified memory dump file from an NCache server.

Which parameters are required for Remove-MemoryDump?

The Server and FileName parameters are required.

What does the Force parameter do?

The Force parameter proceeds with deleting the memory dump without prompting the user.

What is the default port for Remove-MemoryDump?

The default Port value is 9803.

Can credentials be supplied to Remove-MemoryDump?

Yes. The optional Credentials parameter can be used to provide user credentials for authorization.

Which cmdlet creates memory dumps that can later be removed?

New-MemoryDump is used to create memory dumps.

Remove-MemoryDump

The Remove-MemoryDump PowerShell cmdlet is a specialized maintenance utility used to delete diagnostic memory dump files from NCache server nodes. Memory dumps (generated via the New-MemoryDump cmdlet) are vital for deep-dive troubleshooting and crash analysis, but they consume significant disk space. Once diagnostic analysis is complete, administrators use this command to free up storage resources and maintain system hygiene without needing manual file-system access.

Remove-MemoryDump -Server -FileName `
                  [-Port] [-Force] `
                  [-TlsCertPath] [-TlsCertPassword] `
                  [-Credentials] [-NoLogo]

Examples

This command deletes the dump file created on server 20.200.20.11 using port 9803 with the specified name.

Remove-MemoryDump -Server 20.200.20.11 -FileName dumpFile.dmp `
                  -Port 9803

This command deletes the dump file on server 20.200.20.11 with the specified name without prompting the user to cancel it.

Remove-MemoryDump -Server 20.200.20.11 -FileName dumpFile.dmp `
                  -Force

This command removes dumpFile.dmp from the specified server with mutual TLS (mTLS) enabled. It runs from a machine where NCache is not installed and uses C:\certs\client.pem to authenticate the machine running the cmdlet. The -TlsCertPassword parameter decrypts the certificate’s password-protected private key. Omit this parameter if the private key is not encrypted.

Remove-MemoryDump -Server 20.200.20.11 -FileName dumpFile.dmp `
                  -TlsCertPath "C:\certs\client.pem" -TlsCertPassword "clientKeyPassword"

This command deletes the dump file created on server 20.200.20.11 with the specified name, using security credentials.

Remove-MemoryDump -Server 20.200.20.11 -FileName dumpFile.dmp `
                  -Credentials(Get-Credential john_smith)

Properties

Note

The parameters with asterisk (*) on their names are the required parameters and the rest are optional.

Parameters	Data Types	Description	Default Value
`-Server*`	`<String>`	Specifies a server name where the NCache Service is running and a cache with the specified cache-name is registered and the dump was created.	-
`-FileName*`	`<String>`	Specifies the name of the memory dump file that is to be deleted.	-
`-NoLogo`	`<SwitchParameter>`	Suppresses display of the logo banner.	False
`-Port`	`<Integer>`	Specifies the server port where the NCache Service is listening.	9803
`-Force`	`<SwitchParameter>`	Proceeds with deleting the memory dumps without prompting the user to cancel it.	True
`-Credentials`	`<pscredential>`	Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user with the appropriate permissions at the node.	-
`-TlsCertPath`	`<string>`	Path to the client PEM certificate used to authenticate the machine running the NCache PowerShell cmdlet when connecting to an NCache server with mutual TLS (mTLS) enabled. The PEM file must contain the private key, leaf certificate, and any intermediate certificates. You can generate a certificate using `New-NCacheTlsCertificate`. This parameter is required when running the PowerShell module from a machine where NCache is not installed and the server requires mTLS. On a machine with an NCache server installation, the node's own certificate is used automatically. Relative paths are resolved against the current PowerShell location, and the file must exist. To configure the certificate presented by the server, use `-CustomCertificatePath`.	-
`-TlsCertPassword`	`<string>`	Password used to load the encrypted private key in the PEM file specified by `-TlsCertPath`. Required only when the private key is password-protected. Not needed for an unencrypted private key. The password is used only to load the client certificate for the current command's connections. It is not saved in the NCache server configuration.	-

Remove-MemoryDump

Examples

Properties

Note

Contact Us