Sdílet prostřednictvím

Get-AzBatchCertificate

  • Reference
Modul:
Az.Batch

Získá certifikáty v účtu Batch.

Syntaxe

Get-AzBatchCertificate
   [-Filter <String>]
   [-MaxCount <Int32>]
   [-Select <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchCertificate
   [-ThumbprintAlgorithm] <String>
   [-Thumbprint] <String>
   [-Select <String>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Rutina Get-AzBatchCertificate získá certifikáty v účtu Azure Batch, který určuje parametr BatchContext. Pokud chcete získat konkrétní certifikát, zadejte parametry ThumbprintAlgorithm a kryptografický otisk. Zadejte parametr Filter pro získání certifikátů, které odpovídají filtru OData (Open Data Protocol).

Příklady

Příklad 1: Získání certifikátu kryptografickým otiskem

Get-AzBatchCertificate -ThumbprintAlgorithm "sha1" -Thumbprint "C1******7C" -BatchContext $Context

Thumbprint                  : C1******7C
ThumbprintAlgorithm         : sha1
Url                         : https://pstests.eastus.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=C1******47
C)
State                       : Active
StateTransitionTime         : 10/6/2015 6:21:16 PM
PreviousState               :
PreviousStateTransitionTime :
Data                        :
CertificateFormat           :
Password                    :
PublicData                  : MI******FJ
DeleteCertificateError      :

Tento příkaz získá jeden certifikát, který má zadaný kryptografický otisk. Algoritmus kryptografického otisku certifikátu je sha1.

Příklad 2: Získání filtrovaných certifikátů

Get-AzBatchCertificate -Filter "state eq 'active'" -BatchContext $Context

Thumbprint                  : 025b351b087a084c5067f5e71eff8591970323f9
ThumbprintAlgorithm         : sha1
Url                         : https://pstests.eastus.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=02******f9)
State                       : Active
StateTransitionTime         : 10/6/2015 6:21:17 PM
PreviousState               :
PreviousStateTransitionTime :
Data                        :
CertificateFormat           :
Password                    :
PublicData                  : ********************************
DeleteCertificateError      :

Thumbprint                  : C1******7C
ThumbprintAlgorithm         : sha1
Url                         : https://pstests.eastus.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=C1******7C)
State                       : Active
StateTransitionTime         : 10/6/2015 6:21:16 PM
PreviousState               :
PreviousStateTransitionTime :
Data                        :
CertificateFormat           :
Password                    :
PublicData                  : ********************************
DeleteCertificateError      :

Tento příkaz získá všechny certifikáty v aktivním stavu z účtu Batch. Parametr Filter určuje stav.

Parametry

-BatchContext

Určuje instanci BatchAccountContext, kterou tato rutina používá k interakci se službou Batch. Pokud k získání účtu BatchAccountContext použijete rutinu Get-AzBatchAccount, použije se při interakci se službou Batch ověřování Microsoft Entra. Pokud chcete místo toho použít ověřování pomocí sdíleného klíče, použijte rutinu Get-AzBatchAccountKey k získání objektu BatchAccountContext s vyplněnými přístupovými klíči. Při použití ověřování pomocí sdíleného klíče se ve výchozím nastavení používá primární přístupový klíč. Pokud chcete změnit klíč, který chcete použít, nastavte vlastnost BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Filter

Určuje klauzuli filtru OData. Pokud zadáte tento parametr, získá tato rutina certifikáty, které odpovídají filtru.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaxCount

Určuje maximální počet certifikátů, které se mají vrátit. Pokud zadáte hodnotu nula (0) nebo menší, rutina nepoužívá horní limit. Výchozí hodnota je 1000.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Select

Určuje klauzuli OData select. Zadejte hodnotu pro tento parametr, chcete-li získat konkrétní vlastnosti, nikoli všechny vlastnosti objektu.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Thumbprint

Určuje kryptografický otisk certifikátu, který tato rutina získá.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ThumbprintAlgorithm

Určuje algoritmus použitý k odvození kryptografického otisku parametru. V současné době je jedinou platnou hodnotou sha1.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

BatchAccountContext

Výstupy

PSCertificate