Get-AzBatchCertificate
Obtient les certificats dans un compte 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
L’applet de commande Get-AzBatchCertificate obtient les certificats dans le compte Azure Batch spécifié par le paramètre BatchContext . Pour obtenir un certificat particulier, spécifiez les paramètres ThumbprintAlgorithm et Thumbprint . Spécifiez le paramètre Filter pour obtenir les certificats qui correspondent à un filtre OData (Open Data Protocol).
Exemples
Exemple 1 : Obtenir un certificat par empreinte numérique
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 :
Cette commande obtient un certificat unique qui a l’empreinte numérique spécifiée. L’algorithme d’empreinte numérique du certificat est sha1.
Exemple 2 : Obtenir des certificats filtrés
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 :
Cette commande obtient tous les certificats dans l’état actif du compte Batch. Le paramètre Filter spécifie l’état.
Paramètres
-BatchContext
Spécifie l’instance BatchAccountContext utilisée par cette applet de commande pour interagir avec le service Batch. Si vous utilisez l’applet de commande Get-AzBatchAccount pour obtenir votre BatchAccountContext, l’authentification Microsoft Entra sera utilisée lors de l’interaction avec le service Batch. Pour utiliser l’authentification par clé partagée à la place, utilisez l’applet de commande Get-AzBatchAccountKey pour obtenir un objet BatchAccountContext avec ses clés d’accès remplies. Lorsque vous utilisez l’authentification par clé partagée, la clé d’accès primaire est utilisée par défaut. Pour modifier la clé à utiliser, définissez la propriété BatchAccountContext.KeyInUse.
Type: | BatchAccountContext |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Alias: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Filter
Spécifie une clause de filtre OData. Si vous spécifiez ce paramètre, cette applet de commande obtient les certificats qui correspondent au filtre.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-MaxCount
Spécifie le nombre maximal de certificats à retourner. Si vous spécifiez une valeur de zéro (0) ou moins, l’applet de commande n’utilise pas de limite supérieure. La valeur par défaut est 1000.
Type: | Int32 |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Select
Spécifie une clause OData select. Spécifiez une valeur pour ce paramètre afin d’obtenir des propriétés spécifiques plutôt que toutes les propriétés d’objet.
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Thumbprint
Spécifie l’empreinte numérique du certificat que cette applet de commande obtient.
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |
-ThumbprintAlgorithm
Spécifie l’algorithme utilisé pour dériver le paramètre Thumbprint . Actuellement, la seule valeur valide est sha1.
Type: | String |
Position: | 0 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | True |
Accepter les caractères génériques: | False |