Register-AFCacheHost

Article
09/12/2012

Register-AFCacheHost

Adds a cache host to the specified cache cluster configuration store.

Syntax

Parameter Set: Default
Register-AFCacheHost [-ProviderType] <String> [-ConnectionString] <String> [-Account <String> ] [-ArbitrationPort <Int32> ] [-CachePort <Int32> ] [-CacheSize <Int64> ] [-ClusterPort <Int32> ] [-ComputerName <String> ] [-ReplicationPort <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameters

-Account<String>

The Windows account name that is used to run the Caching Service. If you do not want to use a domain account, you should specify the default "NT Authority\Network Service" account.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ArbitrationPort<Int32>

The arbitration port number of the cache host. Possible range is 1024 to 65535.

Aliases	none
Required?	false
Position?	named
Default Value	22235
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-CachePort<Int32>

The cache port number of the cache host. Possible range is 1024 to 65535.

Aliases	none
Required?	false
Position?	named
Default Value	22233
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-CacheSize<Int64>

The size in MB of available caching memory on the cache host. This only accounts for items in the cache and not the memory used for the caching service itself. If this is not specified, it becomes half of the physical memory on the machine. Note that any setting above half the physical memory should be tested thoroughly to ensure that low memory conditions to not occur. Applies to AppFabric 1.1 for Windows Server only.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ClusterPort<Int32>

The cluster port number of the cache host. Possible range is 1024 to 65535.

Aliases	none
Required?	false
Position?	named
Default Value	22234
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ComputerName<String>

The name of the cache host to register in the cache cluster. If this value is not provided, the current cache host is used.

Aliases	none
Required?	false
Position?	named
Default Value	local host
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ConnectionString<String>

The connection string to the provider that contains the cache cluster configuration store.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProviderType<String>

The provider used to store the cluster configuration settings.

XML

System.Data.SqlClient

[Custom Provider Name]

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ReplicationPort<Int32>

The replication port number of the cache host. Possible range is 1024 to 65535.

Aliases	none
Required?	false
Position?	named
Default Value	22236
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Confirm

Prompts you for confirmation before executing the command.

Required?	false
Position?	named
Default Value	none
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	none
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

Examples

PS C:\>

Unregister-AFCacheHost

Register-AFCacheHost