Get-VMConnectAccess

Get-VMConnectAccess

Gets entries showing users and the virtual machines to which they can connect on one or more Hyper-V hosts.

語法

Parameter Set: VMName
Get-VMConnectAccess [[-VMName] <String[]> ] [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-UserName <System.String[]> ] [ <CommonParameters>]

Parameter Set: VMId
Get-VMConnectAccess [-VMId] <Guid[]> [-CimSession <Microsoft.Management.Infrastructure.CimSession[]> ] [-ComputerName <System.String[]> ] [-Credential <System.Management.Automation.PSCredential[]> ] [-UserName <System.String[]> ] [ <CommonParameters>]

詳細描述

The Get-VMConnectAccess cmdlet gets entries showing users and the virtual machines to which they can connect on one or more Hyper-V hosts. This cmdlet is intended for use in providing other applications with the appropriate permissions required to initiate a session with the Virtual Machine Connection protocol. Examples of such applications are Virtual Machine Manager.

參數

-CimSession<Microsoft.Management.Infrastructure.CimSession[]>

在遠端工作階段或遠端電腦上執行 Cmdlet。輸入電腦名稱或工作階段物件，例如 New-CimSession 或 Get-CimSession Cmdlet 的輸出。預設為本機電腦上目前的工作階段。

-ComputerName<System.String[]>

Specifies one or more Hyper-V hosts that run this cmdlet. NetBIOS names, IP addresses, and fully qualified domain names are allowable. The default is the local computer. Use localhost or a dot (.) to specify the local computer explicitly.

-Credential<System.Management.Automation.PSCredential[]>

Specifies one or more user accounts that have permission to perform this action. The default is the current user.

-UserName<System.String[]>

Specifies the user or users for whom connect access entries are being sought.

-VMId<Guid[]>

Specifies the unique identifier of a virtual machine for which connect access entries are being sought.

-VMName<String[]>

Specifies the name of the virtual machine for which connect access entries are being sought.

<CommonParameters>

這個指令程式支援一般參數：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。如需詳細資訊，請參閱 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

輸入

輸入類型是可透過管道傳送至指令程式的物件類型。

輸出

輸出類型是指令程式所發出的物件類型。

• Microsoft.HyperV.PowerShell.VMConnectAce

範例

Example 1

This command gets a list of all the users who have access to connect to any virtual machine on the local computer. The example assumes that the Grant-VMConnectAccess has been run previously for at least one user account.

PS C:\> Get-VMConnectAccess

Example 2

This command gets a list of all the users who have access to connect to virtual machine VM1. The example assumes that the Grant-VMConnectAccess has been run previously for at least one user account for virtual machine VM1.

PS C:\> Get-VMConnectAccess –VMName VM1

Example 3

This command gets a list of all the virtual machines on the local computer that user Contoso\John has access to connect to. The example assumes that the Grant-VMConnectAccess has been run previously to grant access to Contoso\John.

PS C:\> Get-VMConnectAccess –UserName CONTOSO\John