NAME

Get-DcsServerCacheSize

SYNOPSIS

Returns the cache size that is set on a server.

SYNTAX

Get-DcsServerCacheSize -Server <Object> [ -Current] [ -Connection <String> ] [ -PipelineVariable <String> ]

Get-DcsServerCacheSize -Server <Object> [ -UserDefined] [ -Connection <String> ] [ -PipelineVariable <String> ]

Get-DcsServerCacheSize -Server <Object> [ -SystemManaged] [ -Connection <String> ] [ -PipelineVariable <String> ]

Get-DcsServerCacheSize -Server <Object> [ -Pending] [ -Connection <String> ] [ -PipelineVariable <String> ]

DESCRIPTION

Returns the cache size that is set on a server. The cmdlet will return either the current cache size (parameter Current) or the cache size after the server is restarted (parameter Pending). The parameter Pending also indicates whether the cache will be system managed or user defined. Running the cmdlet without either parameter will return the current cache size.

PARAMETERS

-Server<Object>: ServerHostData object, computer name, or ID that identifies a server. The computer name must be unique or the name must be fully qualified.; Required: true; Position: named; Default value:; Accept pipeline input: true (ByValue); Accept wildcard characters: false
-Current<SwitchParameter>: Use this parameter to display the current cache memory being used by SANsymphony software. The value is returned in bytes.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-Connection<String>: Alias of the connection to the server group. If not specified, the default connection will be used.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-PipelineVariable<String>: Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-UserDefined<SwitchParameter>: THIS PARAMETER IS OBSOLETE AND ONLY MAINTAINED FOR BACKWARD COMPATIBILITY. This parameter has been replaced by the parameter Pending.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-SystemManaged<SwitchParameter>: THIS PARAMETER IS OBSOLETE AND ONLY MAINTAINED FOR BACKWARD COMPATIBILITY. This parameter has been replaced by the parameter Current.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false
-Pending<SwitchParameter>: Use this parameter to display the amount of cache memory that will be used by SANsymphony software the next time the server is restarted. In addition to the amount of cache memory, this parameter also indicates whether the cache will be system managed or user-defined by the boolean value for IsSystemManaged. "True" means that the cache setting is system managed or defined by the software; "False" means that the cache setting is user-defined.; Required: false; Position: named; Default value:; Accept pipeline input: false; Accept wildcard characters: false

INPUTS

ServerHostData : Object that identifies the server.

OUTPUTS

DataSize : The object that contains the server cache size.

NOTES

Also see Set-DcsServerCacheSize.

EXAMPLES

-------------- Example 1 Returns current cache size for a server specified by name --------------

Get-DcsServerCacheSize -Server "SSVVM01" -Current

Returns the current cache size for the server "SSVVM01".

Value
-----
2146435072

-------------- Example 2 Returns the pending cache size for a server and System Managed value --------------

Get-DcsServerCacheSize -Server "SSVVM01" -Pending

The cmdlet is invoked to return the cache setting which will be used the next time the server "SSVVM01" is restarted". The value for IsSystemManaged is True, which means that the cache setting is system managed or defined by the software.

Value                                           IsSystemManaged
-----                                           ---------------
2.00 GiB                                                    True