Get-VMConnectAccess

Get-VMConnectAccess

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

Syntax

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>]

Detaillierte Beschreibung

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.

Parameter

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

Das Cmdlet wird in einer Remotesitzung oder auf einem Remotecomputer ausgeführt. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, wie z. B. die Ausgabe eines New-CimSession oder Get-CimSession-Cmdlets. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-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.

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

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

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

Aliase	none
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-UserName<System.String[]>

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

Aliase	UserId,Sid
Erforderlich?	false
Position?	named
Standardwert	none
Pipelineeingaben akzeptieren?	true(ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-VMId<Guid[]>

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

Aliase	none
Erforderlich?	true
Position?	1
Standardwert	none
Pipelineeingaben akzeptieren?	True (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-VMName<String[]>

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

Aliase	none
Erforderlich?	false
Position?	1
Standardwert	none
Pipelineeingaben akzeptieren?	True (ByValue)
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die Sie per Piping an das Cmdlet übergeben können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.HyperV.PowerShell.VMConnectAce

Beispiele

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