共用方式為


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-CimSessionGet-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'}