New-AzBatchCertificate

  • Referenz
Modul:
Az.Batch

Fügt dem angegebenen Batchkonto ein Zertifikat hinzu.

Syntax

New-AzBatchCertificate
   [-FilePath] <String>
   [-Password <SecureString>]
   [-Kind <PSCertificateKind>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzBatchCertificate
   [-RawData] <Byte[]>
   [-Password <SecureString>]
   [-Kind <PSCertificateKind>]
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzBatchCertificate fügt dem angegebenen Azure Batch-Konto ein Zertifikat hinzu.

Beispiele

Beispiel 1: Hinzufügen eines Zertifikats aus einer Datei

New-AzBatchCertificate -FilePath "E:\Certificates\MyCert.cer" -BatchContext $Context

Mit diesem Befehl wird dem angegebenen Batchkonto mithilfe der Datei "E:\Certificates\MyCert.cer" ein Zertifikat hinzugefügt.

Beispiel 2: Hinzufügen eines Zertifikats aus Rohdaten

$RawData = [System.IO.File]::ReadAllBytes("E:\Certificates\MyCert.pfx")
New-AzBatchCertificate -RawData $RawData -Password "Password1234" -BatchContext $Context

Mit dem ersten Befehl werden die Daten aus der Datei "MyCert.pfx" in die variable $RawData gelesen. Mit dem zweiten Befehl wird dem angegebenen Batchkonto mithilfe der in $RawData gespeicherten Rohdaten ein Zertifikat hinzugefügt.

Parameter

-BatchContext

Gibt die BatchAccountContext-Instanz an, die dieses Cmdlet für die Interaktion mit dem Batchdienst verwendet. Wenn Sie das Cmdlet Get-AzBatchAccount verwenden, um Ihren BatchAccountContext abzurufen, wird die Microsoft Entra-Authentifizierung bei der Interaktion mit dem Batchdienst verwendet. Verwenden Sie zum Verwenden der gemeinsamen Schlüsselauthentifizierung stattdessen das Cmdlet "Get-AzBatchAccountKey", um ein BatchAccountContext-Objekt mit den aufgefüllten Zugriffstasten abzurufen. Bei Verwendung der Authentifizierung mit gemeinsam genutzten Schlüsseln wird standardmäßig der primäre Zugriffsschlüssel verwendet. Um den zu verwendenden Schlüssel zu ändern, legen Sie die BatchAccountContext.KeyInUse-Eigenschaft fest.

Type:BatchAccountContext
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FilePath

Gibt den Pfad der Zertifikatdatei an. Die Zertifikatdatei muss im .cer- oder PFX-Format vorliegen.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Kind

Die Art des zu erstellenden Zertifikats. Wenn dies nicht angegeben ist, wird davon ausgegangen, dass alle Zertifikate ohne Kennwort CER sind und alle Zertifikate mit Kennwort PFX sind.

Type:PSCertificateKind
Accepted values:Cer, Pfx
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Gibt das Kennwort für den Zugriff auf den privaten Zertifikatschlüssel an. Sie müssen diesen Parameter angeben, wenn Sie ein Zertifikat im PFX-Format angeben.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RawData

Gibt die Rohzertifikatdaten im .cer- oder PFX-Format an.

Type:Byte[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

Byte[]

BatchAccountContext

Ausgaben

Void