Freigeben über

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.

Typ:BatchAccountContext
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FilePath

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:PSCertificateKind
Zulässige Werte:Cer, Pfx
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:SecureString
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RawData

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

Typ:Byte[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

Byte[]

BatchAccountContext

Ausgaben

Void