Get-Container

Get-Container

Gets information about containers.

語法

Parameter Set: Id
Get-Container [[-Id] <Guid> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [ <CommonParameters>]

Parameter Set: Name
Get-Container [[-Name] <String[]> ] [-CimSession <CimSession[]> ] [-ComputerName <String[]> ] [-Credential <PSCredential[]> ] [ <CommonParameters>]

詳細描述

The Get-Container cmdlet gets information about containers.

參數

-CimSession<CimSession[]>

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

別名	none
必要項？	false
位置？	named
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts to run the 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.

別名	none
必要項？	false
位置？	named
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Credential<PSCredential[]>

Specifies a user account that has permission to perform this action. The default is the current user.

別名	none
必要項？	false
位置？	named
預設值	none
接受管線輸入？	false
接受萬用字元？	false

-Id<Guid>

Specifies the ID of the container that this cmdlet retrieves.

別名	none
必要項？	false
位置？	1
預設值	none
接受管線輸入？	true(ByValue,ByPropertyName)
接受萬用字元？	false

-Name<String[]>

Specifies the name of the container that this cmdlet retrieves.

別名	none
必要項？	false
位置？	1
預設值	none
接受管線輸入？	true(ByValue)
接受萬用字元？	false

<CommonParameters>

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

輸入

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

輸出

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

• Microsoft.Containers.PowerShell.Objects.Container

  Microsoft.Containers.PowerShell.Objects.Container

範例

Example 1: Get information about containers on the local host

This command gets information about all containers on the local host.

PS C:\> Get-Container                        

Example 2: Get information about containers running on a server

This command gets all containers on the host named Server01 that are running.

PS C:\> Get-Container -ComputerName "Server01" | Where-Object {$_.State -eq 'Running'}