< Back
New-AzureRmVpnClientRevokedCertificate
Post
NAME New-AzureRmVpnClientRevokedCertificate
SYNOPSIS
Creates a new VPN client-revocation certificate.
SYNTAX
New-AzureRmVpnClientRevokedCertificate [-DefaultProfile <IAzureContextContainer>] -Name <String> -Thumbprint <String> [<CommonParameters>]
DESCRIPTION
The New-AzureRmVpnClientRevokedCertificate cmdlet creates a new virtual private network (VPN) client-revocation certificate for use on a virtual
network gateway. Client-revocation certificates prevent client computers from using the specified certificate for authentication.
This cmdlet creates a stand-alone certificate that is not assigned to a virtual gateway. Instead, the certificate created by
New-AzureRmVpnClientRevokedCertificate is used in conjunction with the New-AzureRmVirtualNetworkGateway cmdlet when it creates a new gateway. For
instance, suppose you create a new certificate and store it in a variable named $Certificate. You can then use that certificate object when you
create a new virtual gateway. For instance,
`New-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway" -ResourceGroupName "ContosoResourceGroup" -Location "West US" -GatewayType "VPN"
-IpConfigurations $Ipconfig -VPNType "RouteBased" -VpnClientRevokedCertificates $Certificate`
For more information, see the documentation for the New-AzureRmVirtualNetworkGateway cmdlet.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a unique name for the new client-revocation certificate.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Thumbprint <String>
Specifies the unique identifier of the certificate being added.
You can return thumbprint information for your certificates by using a Windows PowerShell command similar to this:
`Get-ChildItem -Path Cert:\\LocalMachine\\Root`
The preceding command returns information for all the Local Computer certificates found in the Root certificate store.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
This cmdlet does not accept pipelined input.
OUTPUTS
This cmdlet creates new instances of the Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate object.
NOTES
Example 1: Create a new client-revoked certificate
PS C:\\>$Certificate = New-AzureRmVpnClientRevokedCertificate -Name "ContosoClientRevokedCertificate" -Thumbprint
"E3A38EBA60CAA1C162785A2E1C44A15AD450199C3"
This command creates a new client-revoked certificate and stores the certificate object in a variable named $Certificate. This variable can then
be used by the New-AzureRmVirtualNetworkGateway cmdlet to add the certificate to a new virtual network gateway.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ertificate
Add-AzureRmVpnClientRevokedCertificate
Get-AzureRmVpnClientRevokedCertificate
Remove-AzureRmVpnClientRevokedCertificate
SYNOPSIS
Creates a new VPN client-revocation certificate.
SYNTAX
New-AzureRmVpnClientRevokedCertificate [-DefaultProfile <IAzureContextContainer>] -Name <String> -Thumbprint <String> [<CommonParameters>]
DESCRIPTION
The New-AzureRmVpnClientRevokedCertificate cmdlet creates a new virtual private network (VPN) client-revocation certificate for use on a virtual
network gateway. Client-revocation certificates prevent client computers from using the specified certificate for authentication.
This cmdlet creates a stand-alone certificate that is not assigned to a virtual gateway. Instead, the certificate created by
New-AzureRmVpnClientRevokedCertificate is used in conjunction with the New-AzureRmVirtualNetworkGateway cmdlet when it creates a new gateway. For
instance, suppose you create a new certificate and store it in a variable named $Certificate. You can then use that certificate object when you
create a new virtual gateway. For instance,
`New-AzureRmVirtualNetworkGateway -Name "ContosoVirtualGateway" -ResourceGroupName "ContosoResourceGroup" -Location "West US" -GatewayType "VPN"
-IpConfigurations $Ipconfig -VPNType "RouteBased" -VpnClientRevokedCertificates $Certificate`
For more information, see the documentation for the New-AzureRmVirtualNetworkGateway cmdlet.
PARAMETERS
-DefaultProfile <IAzureContextContainer>
The credentials, account, tenant, and subscription used for communication with azure.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Name <String>
Specifies a unique name for the new client-revocation certificate.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Thumbprint <String>
Specifies the unique identifier of the certificate being added.
You can return thumbprint information for your certificates by using a Windows PowerShell command similar to this:
`Get-ChildItem -Path Cert:\\LocalMachine\\Root`
The preceding command returns information for all the Local Computer certificates found in the Root certificate store.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
This cmdlet does not accept pipelined input.
OUTPUTS
This cmdlet creates new instances of the Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate object.
NOTES
Example 1: Create a new client-revoked certificate
PS C:\\>$Certificate = New-AzureRmVpnClientRevokedCertificate -Name "ContosoClientRevokedCertificate" -Thumbprint
"E3A38EBA60CAA1C162785A2E1C44A15AD450199C3"
This command creates a new client-revoked certificate and stores the certificate object in a variable named $Certificate. This variable can then
be used by the New-AzureRmVirtualNetworkGateway cmdlet to add the certificate to a new virtual network gateway.
RELATED LINKS
Online Version: https://docs.microsoft.com/en-us/powers ... ertificate
Add-AzureRmVpnClientRevokedCertificate
Get-AzureRmVpnClientRevokedCertificate
Remove-AzureRmVpnClientRevokedCertificate