# New-RASCertificate ### NAME New-RASCertificate\
### SYNOPSIS Creates a Certificate by Importing a Certificate/Pfx file, generating a self-signed certificate or generating a certificate request.\
### SYNTAX New-RASCertificate \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#SiteId)] *\*] -[CommonName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonName) *\* -[Email](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Email) *\* -[RequestFile](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#RequestFile) *\* \[-[AlternateNames](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#AlternateNames) *\*] \[-[City](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#City) *\*] \[-[CountryCode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CountryCode) *\*] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Description) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Enabled) *\*] \[-[FullStateOrProvince](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#FullStateOrProvince) *\*] \[-[KeySize](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#KeySize) {KeySize1024 | KeySize2048 | KeySize4096 | KeySize3072 | KeySize521 | KeySizeUnknown}] \[-[Organisation](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Organisation) *\*] \[-[OrganisationUnit](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#OrganisationUnit) *\*] \[-[Usage](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Usage) {None | Gateway | HALB}] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonParameters)*>*]\ \ New-RASCertificate \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#SiteId)] *\*] -[CommonName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonName) *\* -[Email](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Email) *\* \[-[AlternateNames](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#AlternateNames) *\*] \[-[City](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#City) *\*] \[-[CountryCode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CountryCode) *\*] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Description) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Enabled) *\*] \[-[ExpireInMonths](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#ExpireInMonths) *\*] \[-[FullStateOrProvince](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#FullStateOrProvince) *\*] \[-[KeySize](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#KeySize) {KeySize1024 | KeySize2048 | KeySize4096 | KeySize3072 | KeySize521 | KeySizeUnknown}] \[-[Organisation](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Organisation) *\*] \[-[OrganisationUnit](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#OrganisationUnit) *\*] \[-[Usage](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Usage) {None | Gateway | HALB}] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonParameters)*>*]\ \ New-RASCertificate \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#SiteId)] *\*] -[CertificateFile](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CertificateFile) *\* -[PrivateKeyFile](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#PrivateKeyFile) *\* \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Description) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Enabled) *\*] \[-[Usage](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Usage) {None | Gateway | HALB}] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonParameters)*>*]\ \ New-RASCertificate \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#SiteId)] *\*] -[PfxFile](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#PfxFile) *\* \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Description) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Enabled) *\*] \[-[PfxPassword](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#PfxPassword) *\*] \[-[Usage](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Usage) {None | Gateway | HALB}] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonParameters)*>*]\ \ New-RASCertificate \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#SiteId)] *\*] -[CommonName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonName) *\* -[Email](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Email) *\* -[LetsEncrypt](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#LetsEncrypt) *\* \[-[AlternateNames](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#AlternateNames) *\*] \[-[City](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#City) *\*] \[-[CountryCode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CountryCode) *\*] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Description) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Enabled) *\*] \[-[FullStateOrProvince](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#FullStateOrProvince) *\*] \[-[KeySize](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#KeySize) {KeySize1024 | KeySize2048 | KeySize4096 | KeySize3072 | KeySize521 | KeySizeUnknown}] \[-[Organisation](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Organisation) *\*] \[-[OrganisationUnit](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#OrganisationUnit) *\*] \[-[Usage](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#Usage) {None | Gateway | HALB}] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASCertificate.html#CommonParameters)*>*]\
### DESCRIPTION By default, one is guided to create a Self-Signed Certificate.\ \ A certificate is imported by either specifying a CertificateFile and PrivateKeyFile, or specifying a PfxFile with an optional PfxPassword.\ \ A certificate request can be created by specifying a RequestFile path to output the request to.\
### PARAMETERS \ -**Name \**\ The name of the target Certificate.\
``` Required? true ``` ``` Position? 0 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SiteId \**\ Site ID in which to add the Certificate.\
``` Required? false ``` ``` Position? 1 ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Description \**\ A user-defined Certificate description.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PfxFile \**\ Certificate file name in pfx format.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PfxPassword \**\ The password of the pfx file specified in the PfxFile parameter.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PrivateKeyFile \**\ Private key file name.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CertificateFile \**\ Certificate file name.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Usage <**[**CertificateUsages**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/CertificateUsages.html)**>**\ A set of usages to assign. To form a set of usages 'OR' individual usage enum IDs.\ \ Possible values: None, Gateway, HALB\
``` Required? false ``` ``` Position? named ``` ``` Default value Gateway, HALB ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Enabled \**\ Whether to enable or disable the certificate being created.\
``` Required? false ``` ``` Position? named ``` ``` Default value True ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**KeySize <**[**CertificateKeySize**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/CertificateKeySize.html)**>**\ The Key Size for the certificate to be generated.\ \ Possible values: KeySize1024, KeySize2048, KeySize4096, KeySize3072, KeySize521, KeySizeUnknown\
``` Required? false ``` ``` Position? named ``` ``` Default value KeySize2048 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CountryCode \**\ The Country Code for the certificate to be generated.\ \ By default, the country code from the PowerShell region information is used.\
``` Required? false ``` ``` Position? named ``` ``` Default value US ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ExpireInMonths \**\ Specifies the length of validity of the certificate being generated.\
``` Required? false ``` ``` Position? named ``` ``` Default value 12 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**FullStateOrProvince \**\ The Full State or Province for the certificate to be generated.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**City \**\ The City for the certificate to be generated.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Organisation \**\ The Organisation for the certificate to be generated.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**OrganisationUnit \**\ The Organisation Unit for the certificate to be generated.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Email \**\ The Email for the certificate to be generated.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CommonName \**\ The Common Name for the certificate to be generated.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**AlternateNames \**\ The Alternate Names for the certificate to be generated.\ \ eg. IP:1.2.3.4,DNS:example.com\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**RequestFile \**\ Request file name to output Request Certificate to.\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**LetsEncrypt \**\ Let's Encrypt SwitchParameter\
``` Required? true ``` ``` Position? named ``` ``` Default value False ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ \ ``` This cmdlet supports the common parameters: Verbose, Debug, ``` ``` ErrorAction, ErrorVariable, WarningAction, WarningVariable, ``` ``` OutBuffer, PipelineVariable, and OutVariable. For more information, see ``` ``` about_CommonParameters . ```
### INPUTS -none- ### OUTPUTS [Certificate](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Certificate.html) ### EXAMPLES \ \&#xNAN;**---------- EXAMPLE 1 ----------**\ \ New-RASCertificate -Name "ImportedCert" -SiteId 1 -Description "Certificate" -Usage Gateway -Enabled $true -PrivateKeyFile "C:\key.pem" -CertificateFile "C:\cert.pem"\ \ Imports a certificate from the files key.pem and cert.pem to a certificate object with Name "ImportedCert" on Site 1.\ \&#xNAN;**---------- EXAMPLE 2 ----------**\ \ New-RASCertificate -Name "ImportedPfx" -SiteId 1 -Description "Certificate" -Usage Gateway -Enabled $true -PfxFile "C:\cert.pfx" -PfxPassword $pfxPassword\ \ Imports a certificate from a pfx file cert.pfx to a certificate object with Name "ImportedPfx" on Site 1.\ \&#xNAN;**---------- EXAMPLE 3 ----------**\ \ New-RASCertificate -Name "SelfSignedCert" -SiteId 1 -Description "Certificate" -Usage Gateway -Enabled $true -Email "" -CommonName "TestCert" -AlternateNames "DNS:\*.example.com,IP:1.2.3.4,IP:::1"\ \ Generates a self-signed certificate with Name "SelfSignedCert" on Site 1.\ \&#xNAN;**---------- EXAMPLE 4 ----------**\ \ New-RASCertificate -Name "CertRequest" -SiteId 1 -Description "Certificate" -Usage Gateway -Enabled $true -Email "" -CommonName "TestCert" -RequestFile "C:\req.crt" -AlternateNames "DNS:example.com,IP:1.2.3.4,IP:::1"\ \ Generates a certificate request with Name "CertRequest" on Site 1, and saves the request to req.crt --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parallels.com/landing/ras-powershell-api-guide/v19/parallels-ras-powershell-admin-module/commands/new-rascertificate.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.