Freigeben über


Get-AzContainerGroup

Ruft die Eigenschaften der angegebenen Containergruppe in der angegebenen Abonnement- und Ressourcengruppe ab. Der Vorgang gibt die Eigenschaften jeder Containergruppe einschließlich Containern, Imageregistrierungsanmeldeinformationen, Neustartrichtlinie, IP-Adresstyp, Betriebssystemtyp, Status und Volumes zurück.

Syntax

List (Standard)

Get-AzContainerGroup
    [-SubscriptionId <String[]>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Get

Get-AzContainerGroup
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String[]>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

List1

Get-AzContainerGroup
    -ResourceGroupName <String>
    [-SubscriptionId <String[]>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

GetViaIdentity

Get-AzContainerGroup
    -InputObject <IContainerInstanceIdentity>
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Beschreibung

Ruft die Eigenschaften der angegebenen Containergruppe in der angegebenen Abonnement- und Ressourcengruppe ab. Der Vorgang gibt die Eigenschaften jeder Containergruppe einschließlich Containern, Imageregistrierungsanmeldeinformationen, Neustartrichtlinie, IP-Adresstyp, Betriebssystemtyp, Status und Volumes zurück.

Beispiele

Beispiel 1: Auflisten aller Containergruppen im aktuellen Abonnement

Get-AzContainerGroup
Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg1      test-rg
eastus   test-cg2      test-rg

Dieser Befehl ruft alle Containergruppen im aktuellen Abonnement ab.

Beispiel 2: Abrufen einer bestimmten Containergruppe

Get-AzContainerGroup -Name test-cg1 -ResourceGroupName test-rg | Format-List
Container                      : {test-container1}
DnsConfigNameServer            :
DnsConfigOption                :
DnsConfigSearchDomain          :
EncryptionPropertyKeyName      :
EncryptionPropertyKeyVersion   :
EncryptionPropertyVaultBaseUrl :
IPAddressDnsNameLabel          :
IPAddressFqdn                  :
IPAddressIP                    : 000.000.000.000
IPAddressPort                  : {Microsoft.Azure.PowerShell.Cmdlets.ContainerInsta
                                 nce.Models.Api20210301.Port, Microsoft.Azure.Power
                                 Shell.Cmdlets.ContainerInstance.Models.Api20210301
                                 .Port}
IPAddressType                  : Public
Id                             : /subscriptions/00000000-0000-0000-0000-000000000000
                                 0/resourceGroups/test-rg/providers/Microsoft.Contai
                                 nerInstance/containerGroups/test-cg1
IdentityPrincipalId            :
IdentityTenantId               :
IdentityType                   :
IdentityUserAssignedIdentity   : Microsoft.Azure.PowerShell.Cmdlets.ContainerInstan
                                 ce.Models.Api20210301.ContainerGroupIdentityUserAs
                                 signedIdentities
ImageRegistryCredentials       :
InitContainer                  : {}
InstanceViewEvent              :
InstanceViewState              :
Location                       : eastus
LogAnalyticLogType             :
LogAnalyticMetadata            : Microsoft.Azure.PowerShell.Cmdlets.ContainerInstan
                                 ce.Models.Api20210301.LogAnalyticsMetadata
LogAnalyticWorkspaceId         :
LogAnalyticWorkspaceKey        :
LogAnalyticWorkspaceResourceId : Microsoft.Azure.PowerShell.Cmdlets.ContainerInstan
                                 ce.Models.Api20210301.LogAnalyticsWorkspaceResourc
                                 eId
Name                           : test-cg1
NetworkProfileId               :
OSType                         : Linux
ProvisioningState              : Succeeded
ResourceGroupName              : test-rg
RestartPolicy                  : Never
Sku                            : Standard
Tag                            : Microsoft.Azure.PowerShell.Cmdlets.ContainerInstan
                                 ce.Models.Api20210301.ResourceTags
Type                           : Microsoft.ContainerInstance/containerGroups
Volume                         :

Der Befehl ruft die angegebene Containergruppe ab.

Beispiel 3: Abrufen von Containergruppen in einer Ressourcengruppe

Get-AzContainerGroup -ResourceGroupName test-rg
Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg1      test-rg
eastus   test-cg2      test-rg

Der Befehl ruft die Containergruppen in der Ressourcengruppe test-rgab.

Beispiel 4: Abrufen einer Containergruppe durch Piping

Update-AzContainerGroup -Name test-cg1 -ResourceGroupName test-rg -Tag @{"test"="value"} | Get-AzContainerGroup
Location Name    Zone ResourceGroupName
-------- ----    ---- -----------------
eastus   test-cg1      test-rg

Der Befehl ruft die aktualisierte Containergruppe durch Piping ab.

Parameter

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Parametereigenschaften

Typ:PSObject
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzureRMContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Identitätsparameter Zu erstellen finden Sie im Abschnitt NOTES für INPUTOBJECT-Eigenschaften, und erstellen Sie eine Hashtabelle.

Parametereigenschaften

Typ:IContainerInstanceIdentity
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GetViaIdentity
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Der Name der Containergruppe.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Containergruppenname

Parametersätze

Get
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Get
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
List1
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Parametereigenschaften

Typ:

String[]

Standardwert:(Get-AzContext).Subscription.Id
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

List
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
Get
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
List1
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

IContainerInstanceIdentity

Ausgaben

IContainerGroup