New-AzVpnClientRootCertificate

Létrehoz egy új VPN-ügyfél főtanúsítványát.

Syntax

Default (Alapértelmezett)

New-AzVpnClientRootCertificate
    -Name <String>
    -PublicCertData <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

A New-AzVpnClientRootCertificate parancsmag létrehoz egy új VPN-főtanúsítványt a virtuális hálózati átjárón való használatra. A főtanúsítványok olyan X.509-tanúsítványok, amelyek azonosítják a legfelső szintű hitelesítésszolgáltatót: az átjárón használt összes többi tanúsítvány megbízik a főtanúsítványban. Ez a parancsmag létrehoz egy különálló tanúsítványt, amely nincs hozzárendelve virtuális átjáróhoz. Ehelyett a New-AzVpnClientRootCertificate által létrehozott tanúsítvány a New-AzVirtualNetworkGateway parancsmaggal együtt használatos egy új átjáró létrehozásakor. Tegyük fel például, hogy létrehoz egy új tanúsítványt, és egy $Certificate nevű változóban tárolja. Ezután ezt a tanúsítványobjektumot használhatja új virtuális átjáró létrehozásakor. Például New-AzVirtualNetworkGateway -Name "ContosoVirtualGateway" -ResourceGroupName "ContosoResourceGroup" -Location "West US" -GatewayType "VPN" -IpConfigurations $Ipconfig -VPNType "RouteBased" -VpnClientRootCertificates $Certificate További információt a New-AzVirtualNetworkGateway parancsmag dokumentációjában talál.

Példák

1. példa: Ügyfél főtanúsítványának létrehozása

$Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer"
$CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i++){$Text[$i]}
$Certificate = New-AzVpnClientRootCertificate -PublicCertData $CertificateText -Name "ContosoClientRootCertificate"

Ez a példa létrehoz egy ügyfél főtanúsítványt, és a tanúsítványobjektumot egy $Certificate nevű változóban tárolja. Ezt a változót a New-AzVirtualNetworkGateway parancsmag használhatja főtanúsítvány új virtuális hálózati átjáróhoz való hozzáadásához. Az első parancs a Get-Content parancsmagot használja a főtanúsítvány korábban exportált szövegének megjelenítéséhez; a szöveges adatokat egy $Text nevű változó tárolja. A második parancs ezután egy ciklus használatával kinyeri az összes szöveget az első és az utolsó sor kivételével, és a kinyert szöveget egy $CertificateText nevű változóban tárolja. A harmadik parancs a New-AzVpnClientRootCertificate parancsmaggal hozza létre a tanúsítványt, amely a létrehozott objektumot egy $Certificate nevű változóban tárolja.

Paraméterek

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Paramétertulajdonságok

Típus:IAzureContextContainer
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:AzContext, AzureRmContext, AzureCredential

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

Megadja az új ügyfél főtanúsítványának nevét.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-PublicCertData

Megadja a hozzáadni kívánt főtanúsítvány szöveges ábrázolását. A szövegmegjelenítés beszerzéséhez exportálja a tanúsítványt .cer formátumban (Base64 kódolással), majd nyissa meg az eredményként kapott fájlt egy szövegszerkesztőben. Ehhez hasonló kimenetnek kell megjelennie (vegye figyelembe, hogy a tényleges kimenet sokkal több sornyi szöveget tartalmaz, mint az itt látható rövidített minta): ----- BEGIN CERTIFICATE ----- MIIC13FAAXC3671Auij9HgUNEW8343NMJklo 09982CVVFAw8w ----- END CERTIFICATE ----- A PublicCertData a fájl első sora (----- BEGIN CERTIFICATE -----) és az utolsó sor (----- ZÁRÓTANÚSÍTVÁNY -----) közötti összes sorból áll. A PublicCertData a következőhöz hasonló Windows PowerShell-parancsokkal kérhető le: $Text = Get-Content -Path "C:\Azure\Certificates\ExportedCertificate.cer" $CertificateText = for ($i=1; $i -lt $Text.Length -1 ; $i+){$Text[$i]}

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

Kimenetek

PSVpnClientRootCertificate