Get-AzBatchCertificate
Obtém os certificados em uma conta de 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 :
Este comando obtém um único certificado com 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 :
Este comando obtém todos os certificados no estado ativo da conta Batch. 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 Batch. Se você usar o cmdlet Get-AzBatchAccount para obter seu BatchAccountContext, a autenticação do Microsoft Entra será usada ao interagir com o serviço Batch. 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 |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | 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 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-MaxCount
Especifica o número máximo de certificados a serem retornados. Se você especificar um valor de zero (0) ou menos, o cmdlet não usará um limite superior. O valor predefinido é 1000.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Select
Especifica uma cláusula de seleção OData. Especifique um valor para esse parâmetro para obter propriedades específicas em vez de todas as propriedades do objeto.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Thumbprint
Especifica a impressão digital do certificado que este cmdlet obtém.
Tipo: | String |
Position: | 1 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |
-ThumbprintAlgorithm
Especifica o algoritmo usado para derivar o parâmetro Thumbprint . Atualmente, o único valor válido é sha1.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |