Partilhar via

Remove-AzVpnClientRootCertificate

Módulo:
Az.Network Module

Remove um certificado raiz de cliente VPN existente.

Sintaxe

Default (Predefinição) 

Remove-AzVpnClientRootCertificate
    -VpnClientRootCertificateName <String>
    -VirtualNetworkGatewayName <String>
    -ResourceGroupName <String>
    -PublicCertData <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet Remove-AzVpnClientRootCertificate remove o certificado raiz especificado de um gateway de rede virtual. Os certificados raiz são certificados X.509 que identificam sua Autoridade de Certificação Raiz: todos os outros certificados usados no gateway confiam no certificado raiz. Se você remover um certificado raiz, os computadores que usam o certificado para fins de autenticação não poderão mais se conectar ao gateway. Ao usar Remove-AzVpnClientRootCertificate, você deve fornecer o nome do certificado e uma representação de texto dos dados do certificado. Para obter mais informações sobre a representação de texto de um certificado, consulte a descrição do parâmetro PublicCertData .

Exemplos

Exemplo 1: Remover um certificado raiz do cliente de um gateway de rede virtual

$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
Remove-AzVpnClientRootCertificate -PublicCertData $CertificateText -ResourceGroupName "ContosoResourceGroup" -VirtualNetworkGatewayName "ContosoVirtualGateway" -VpnClientRootCertificateName "ContosoRootCertificate"

Este exemplo remove um certificado raiz do cliente chamado ContosoRootCertificate do gateway de rede virtual ContosoVirtualGateway. O primeiro comando usa o cmdlet Get-Content para obter uma representação de texto exportada anteriormente do certificado; Essa representação de texto é armazenada em uma variável chamada $Text. O segundo comando usa um loop for para extrair todo o texto em $Text exceto a primeira linha e a última linha. Esse texto extraído é armazenado em uma variável chamada $CertificateText. O terceiro comando usa as informações armazenadas na variável $CertificateText junto com o cmdlet Remove-AzVpnClientRootCertificate para remover o certificado do gateway.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PublicCertData

Especifica a representação de texto do certificado raiz a ser removido. Para obter a representação de texto, exporte seu certificado em formato .cer (usando Base64) e abra o arquivo resultante em um editor de texto. Você deve ver uma saída semelhante à seguinte (observe que a saída real conterá muito mais linhas de texto do que o exemplo abreviado mostrado aqui): ----- INICIAR CERTIFICADO ----- MIIC13FAAXC3671Auij9HHgUNEW8343NMJklo09982CVVFAw8w ----- END CERTIFICATE ----- O PublicCertData é composto por todas as linhas entre a primeira linha (----- BEGIN CERTIFICATE -----) e a última linha (----- END CERTIFICATE -----) no arquivo. Você pode recuperar o PublicCertData usando comandos do Windows PowerShell semelhantes a este: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer" $CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o gateway de rede virtual está atribuído. Os grupos de recursos categorizam itens para ajudar a simplificar o gerenciamento de inventário e a administração geral do Azure.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-VirtualNetworkGatewayName

Especifica o nome do gateway de rede virtual do qual o certificado é removido.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-VpnClientRootCertificateName

Especifica o nome do certificado raiz do cliente que este cmdlet remove.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome do Recurso

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

Boolean