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és par le paramètre BatchContext. Pour obtenir un certificat particulier, spécifiez les paramètres ThumbprintAlgorithm et d’empreinte numérique. 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 1 000.
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 d’empreinte numérique. 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 |