Get-ClusterAccess
Gets information about permissions that control access to a failover cluster.
Syntax
Get-ClusterAccess
[[-User] <StringCollection>]
[-InputObject <PSObject>]
[-Cluster <String>]
[<CommonParameters>] Description
The Get-ClusterAccess cmdlet gets information about permissions that control access to a failover cluster.
A cluster can allow full access or read-only access. Read-only access limits the user to Windows PowerShell® cmdlets that provide information about the cluster.
Examples
Example 1
PS C:\> Get-ClusterAccess
IdentityReference AccessControlType ClusterRights
----------------- ----------------- -------------
CONTOSO\user1 Deny Full
NT AUTHORITY\SYSTEM Allow Full
NT AUTHORITY\NETWORK SE... Allow Full
BUILTIN\Administrators Allow Full
CONTOSO\user2 Allow Read
NT SERVICE\MSDTC Allow FullThis example lists the level of permissions that have been assigned to users of this cluster, including users who are blocked from access.
Parameters
-Cluster
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Specifies the cluster on which to enumerate cluster access details.
| Type: | PSObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-User
Specifies the user for which to get cluster access.
| Type: | StringCollection |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Microsoft.FailoverClusters.PowerShell.Cluster
Outputs
Microsoft.FailoverClusters.PowerShell.ClusterAccessRule