Compartilhar via

Get-AzBatchCertificate

  • Referência
Módulo:
Az.Batch

Obtém os certificados em uma conta do Lote.

Sintaxe

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

O cmdlet Get-AzBatchCertificate obtém os certificados na conta do Lote do Azure que o parâmetro BatchContext especifica. Para obter um certificado específico, especifique os parâmetros ThumbprintAlgorithm e Thumbprint. Especifique o parâmetro Filter para obter os certificados que correspondem a um filtro OData (Open Data Protocol).

Exemplos

Exemplo 1: Obter um certificado por impressão digital

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      :

Esse comando obtém um único certificado que tem a impressão digital especificada. O algoritmo de impressão digital do certificado é sha1.

Exemplo 2: Obter certificados filtrados

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      :

Esse comando obtém todos os certificados no estado ativo da conta do Lote. O parâmetro Filter especifica o estado.

Parâmetros

-BatchContext

Especifica a instância BatchAccountContext que esse cmdlet usa para interagir com o serviço do Lote. Se você usar o cmdlet Get-AzBatchAccount para obter o BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço do Lote. Para usar a autenticação de chave compartilhada, use o cmdlet Get-AzBatchAccountKey para obter um objeto BatchAccountContext com suas chaves de acesso preenchidas. Ao usar a autenticação de chave compartilhada, a chave de acesso primária é usada por padrão. Para alterar a chave a ser usada, defina a propriedade BatchAccountContext.KeyInUse.

Tipo:BatchAccountContext
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Filter

Especifica uma cláusula de filtro OData. Se você especificar esse parâmetro, esse cmdlet obterá os certificados que correspondem ao filtro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MaxCount

Especifica o número máximo de certificados a serem retornados. Se você especificar um valor igual a zero (0) ou menor, o cmdlet não usará um limite superior. O valor padrão é 1000.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Select

Especifica uma cláusula de seleção OData. Especifique um valor para esse parâmetro obter propriedades específicas em vez de todas as propriedades de objeto.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Thumbprint

Especifica a impressão digital do certificado que este cmdlet obtém.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ThumbprintAlgorithm

Especifica o algoritmo usado para derivar o parâmetro de impressão digital . Atualmente, o único valor válido é sha1.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

BatchAccountContext

Saídas

PSCertificate