New-AzureBatchCertificate

Adds a certificate to the specified Batch account.

Syntax

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

Description

The New-AzureBatchCertificate cmdlet adds a certificate to the specified Azure Batch account.

Examples

Example 1: Add a certificate from a file

PS C:\>New-AzureBatchCertificate -FilePath "E:\Certificates\MyCert.cer" -BatchContext $Context

This command adds a certificate to the specified Batch account by using the file E:\Certificates\MyCert.cer.

Example 2: Add a certificate from raw data

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

The first command reads the data from the file named MyCert.pfx into the $RawData variable.

The second command adds a certificate to the specified Batch account using the raw data stored in $RawData.

Required Parameters

-BatchContext

Specifies the BatchAccountContext instance that this cmdlet uses to interact with the Batch service. If you use the Get-AzureRmBatchAccount cmdlet to get your BatchAccountContext, then Azure Active Directory authentication will be used when interacting with the Batch service. To use shared key authentication instead, use the Get-AzureRmBatchAccountKeys cmdlet to get a BatchAccountContext object with its access keys populated. When using shared key authentication, the primary access key is used by default. To change the key to use, set the BatchAccountContext.KeyInUse property.

Type:Microsoft.Azure.Commands.Batch.BatchAccountContext
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-FilePath

Specifies the path of the certificate file. The certificate file must be in either .cer or .pfx format.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RawData

Specifies the raw certificate data in either .cer or .pfx format.

Type:System.Byte[]
Position:0
Default value:None
Accept pipeline input:True (ByPropertyName, ByValue)
Accept wildcard characters:False

Optional Parameters

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

Type:Microsoft.Azure.Commands.Common.Authentication.Abstractions.IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Password

Specifies the password to access the certificate private key. You must specify this parameter if you specify a certificate in .pfx format.

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

Inputs

BatchAccountContext

Parameter 'BatchContext' accepts value of type 'BatchAccountContext' from the pipeline

Inputs

Byte[]

Parameter 'RawData' accepts value of type 'Byte[]' from the pipeline