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.