Add-ClusterResourceType
Add-ClusterResourceType
Adds a resource type to a failover cluster, and specifies information such as the dynamic-link library (DLL) to use with that resource type.
Syntax
Parameter Set: InputObject
Add-ClusterResourceType [-Name] <String> [-Dll] <String> [[-DisplayName] <String> ] [-Cluster <String> ] [-InputObject <PSObject> ] [ <CommonParameters>]
Detailed Description
The Add-ClusterResourceType cmdlet adds a resource type to a failover cluster, and specifies information such as the dynamic-link library (DLL) to use with that resource type.
The failover cluster software provides Resource DLL files for the most common types of resources. Using the application programming interface (API) provided in the Microsoft Platform Software Development Kit (SDK), other vendors can add support for other resource types.
Note: This cmdlet cannot be run remotely without Credential Security Service Provider (CredSSP) authentication on the server computer.
Parameters
-Cluster<String>
Specifies the name of the cluster on which to run this cmdlet. If the input for this parameter is . or it is omitted, then the cmdlet runs on the local cluster.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-DisplayName<String>
Specifies the display name for the resource type.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Dll<String>
Specifies the DLL file path for the resource type.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-InputObject<PSObject>
Specifies the cluster on which to register the new resource type.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
true (ByValue) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies the name of the cluster resource type to register.
Aliases |
none |
Required? |
true |
Position? |
1 |
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- Microsoft.FailoverClusters.PowerShell.Cluster
Outputs
The output type is the type of the objects that the cmdlet emits.
- Microsoft.FailoverClusters.PowerShell.ClusterResourceType
Examples
EXAMPLE 1
This example creates ResType3 on the local cluster using res3.dll located on the provided resource DLL file path C:\.
PS C:\> Add-ClusterResourceType -Name ResType3 –InputObject C:\res3.dll
EXAMPLE 2
This example creates ResType4 on the local cluster using res4.dll located on the provided resource DLL file path C:\. The display name of the resource type is Resource Type 4.
PS C:\> Add-ClusterResourceType –Name ResType4 -InputObject C:\res4.dll -DisplayName "Resource Type 4"