Get-Topics
This lists all topics registered on a specified Pub/Sub Messaging cache. It lists down the topic names and the respective number of subscribers and publishers against each Pub/Sub Messaging topic name.
Get-Topics [-CacheName] [-Server] [-Port] [-Detail] [-ShowAll] [-NoLogo] [-Credentials]
These properties are explained in detail in the Properties section.
Note
-Detail and -ShowAll are exclusive to NCache Enterprise.
Examples of Get-Topics
- This command gets topics registered on demoCache.
Get-Topics –CacheName demoCache
- This command gets topics registered on demoCache existing on server 20.200.20.11.
Get-Topics –CacheName demoCache –Server 20.200.20.11
- This command uses port and gets topics registered on demoCache existing on server 20.200.20.11.
Get-Topics -CacheName demoCache -Server 20.200.20.11 -Port 8250
- This command shows all the subscriptions associated with the topic.
Get-Topics -CacheName demoCache -Detail
- This command shows details of all the subscribers, publishers, topic priority assigned, subscriptions, and messages associated with the topic.
Get-Topics -CacheName demoCache -ShowAll
- This command authenticates the credentials provided and lists all topics and number of corresponding subscribers and publishers registered on demoCache, using port 8250 by default.
Get-Topics –CacheName demoCache -Credentials john_smith
Properties
Note
The parameters with asterisk (*) on their names are the required parameters and the rest are optional.
| Parameters | Data Type | Description | Default Value |
|---|---|---|---|
-CacheName* |
<String> |
Pub/Sub Messaging Cache name for which the topics are to be listed. | - |
-Server |
<String> |
The server name on which the NCache Service is running. | IP of the local machine |
-Port |
<Integer> |
The port on which NCache server is listening. | 8250 |
-Detail |
<SwitchParameter> |
Specifies all the subscriptions associated with the topic. | - |
-ShowAll |
<SwitchParameter> |
Specifies details of all the subscribers, publishers, topic priority assigned, subscriptions, and messages associated with the topic. | - |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | - |
-Credentials |
<pscredential> |
Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user who has appropriate permissions at the node. | - |
