Revoke Connect Access
This Automation Manager object revokes access for one or more users to connect to one or more virtual machines. This cmdlet is intended for use in providing other applications with the appropriate permissions required to initiate a session with Virtual Machine Connection. Examples of such applications are Virtual Machine Manager.
Input Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| VM Name | String | Yes | Specifies the name or names of the virtual machine or machines to which access is being revoked. |
| User Name | String | Yes | Specifies the user or users to whom access to connect to a virtual machine or machines is to be revoked |
Output Parameters
| Name | Type | Description |
|---|---|---|
| Result | Number | Returns a success value of zero or any value other than zero to indicate failure. |
Example Input Parameters
| Name | Type | Required | Example |
|---|---|---|---|
| VM Name | String | Yes | Guest001 |
| User Name | String | Yes |
User Name must be in the form of Local User Account: john or ComputerName\john Domain User Account: CONTOSO\john or Contoso.com\john User Principal Name (UPN): john@contoso.com Security Identifier: S-1-5-21-3165297888-301567370-576410423-1103 |