Get-NetworkSwitchEthernetPort
S'applique à: Windows 10 Technical Preview
Get-NetworkSwitchEthernetPort
Gets port information for a network switch.
Syntaxe
Parameter Set: DeviceIDSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> [-DeviceId <String> ] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
Parameter Set: FullDuplexDisabledSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -FullDuplexDisabled [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
Parameter Set: FullDuplexEnabledSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -FullDuplexEnabled [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
Parameter Set: PortNumberSet
Get-NetworkSwitchEthernetPort -CimSession <CimSession> -PortNumber <Int32> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]
Description détaillée
The Get-NetworkSwitchEthernetPort cmdlet gets port information for a network switch.
Paramètres
-CimSession<CimSession>
Specifies the CimSession that this cmdlet uses to connect to the network switch. For more information about CimSession objects, type Get-Help New-CimSession
.
Alias |
none |
Requis ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-DeviceId<String>
Specifies a device ID. This cmdlet gets information for the port that this parameter specifies.
Alias |
none |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FullDuplexDisabled
Indicates that this cmdlet returns only ports that have FullDuplex disabled.
Alias |
none |
Requis ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-FullDuplexEnabled
Indicates that this cmdlet returns only ports that have FullDuplex enabled.
Alias |
none |
Requis ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Les valeurs acceptables pour ce paramètre sont les suivantes :
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Alias |
infa |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Alias |
iv |
Requis ? |
false |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-PortNumber<Int32>
Specifies a port number. This cmdlet gets the port that the parameter specifies.
Alias |
none |
Requis ? |
true |
Position ? |
named |
Valeur par défaut |
none |
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez . about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d'entrée correspond au type des objets que vous pouvez adresser à l'applet de commande.
- None
Sorties
Le type de sortie correspond au type des objets que l'applet de commande émet.
CimInstance[]
This cmdlet returns an array of CimInstance objects that correspond to Ethernet ports on a network switch.
Exemples
Example 1: Get all the ports for a device
The first command creates a CimSession for a network switch, and then stores it in the $Session variable. For more information about CimSession objects, type Get-Help New-CimSession
.
The second command gets the ports for NetworkSwitch08 by using the $Session object.
PS C:\> $Session = New-CimSession -ComputerName "NetworkSwitch08"
PS C:\> Get-NetworkSwitchEthernetPort -CimSession $Session
Example 2: Get a specific port
This command gets port 21. The example shows the console output for the command. The command includes a CimSession, similar to the first example.
PS C:\> Get-NetworkSwitchEthernetPort -PortNumber 21 -CimSession $Session
Example 3: Get a port with a specified ID
This command gets the port for the device that has the ID Ethernet17. The command includes a CimSession, similar to the first example.
PS C:\> Get-NetworkSwitchEthernetPort -DeviceID "Ethernet17" -CimSession $Session