Add-AzVMSecret
Titkos kulcsot ad hozzá egy virtuális géphez.
Syntax
Default (Alapértelmezett)
Add-AzVMSecret
[-VM] <PSVirtualMachine>
[[-SourceVaultId] <String>]
[[-CertificateStore] <String>]
[[-CertificateUrl] <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
Az Add-AzVMSecret parancsmag titkos kulcsot ad hozzá egy virtuális géphez. Ez az érték lehetővé teszi tanúsítvány hozzáadását a virtuális géphez. A titkos kulcsot egy Key Vault kell tárolni. További információk a Key Vaultról: Mi az Azure Key Vault?. A parancsmagokkal kapcsolatos további információkért lásd: Azure Key Vault parancsmagok vagy a Set-AzKeyVaultSecret parancsmag.
Note
Tanúsítványok virtuális gépre való telepítéséhez ajánlott a
Példák
Példa: Titkos kód hozzáadása virtuális géphez Add-AzVMSecret
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
$Credential = Get-Credential
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName "Contoso26" -Credential $Credential
$SourceVaultId = "/subscriptions/46f8cea4-2de6-4179-8ab1-365da4211af4/resourceGroups/vault/providers/Microsoft.KeyVault/vaults/keyvault"
$CertificateStore01 = "My"
$CertificateUrl01 = "https://contosovault.vault.azure.net/secrets/514ceb769c984379a7e0230bdd703272"
$VirtualMachine = Add-AzVMSecret -VM $VirtualMachine -SourceVaultId $SourceVaultId -CertificateStore $CertificateStore01 -CertificateUrl $CertificateUrl01
Az első parancs létrehoz egy virtuálisgép-objektumot, majd a $VirtualMachine változóban tárolja.
A parancs nevet és méretet rendel a virtuális géphez.
A második parancs létrehoz egy hitelesítő objektumot a Get-Credential parancsmag használatával, majd az eredményt a $Credential változóban tárolja.
A parancssorban meg kell adnia a felhasználónevet és a jelszót.
További információkért írja be a következőt Get-Help Get-Credential:
A harmadik parancs a Set-AzVMOperatingSystem parancsmaggal konfigurálja a $VirtualMachine tárolt virtuális gépet.
A negyedik parancs egy forrástároló-azonosítót rendel hozzá a $SourceVaultId változóhoz későbbi használatra.
A parancs feltételezi, hogy a $SubscriptionId változónak megfelelő értéke van.
Az ötödik parancs egy értéket rendel a $CertificateStore 01 változóhoz későbbi használatra.
A hatodik parancs egy tanúsítványtároló URL-címét rendeli hozzá.
A hetedik parancs hozzáad egy titkos kulcsot a $VirtualMachine tárolt virtuális géphez.
A SourceVaultId paraméter határozza meg a Key Vault.
A parancs megadja a tanúsítványtároló nevét és a tanúsítvány URL-címét.
Az Add-AzVMSecret ismételt futtatásával titkos kulcsokat adhat hozzá más tanúsítványokhoz.
Paraméterek
-CertificateStore
Megadja a tanúsítványtároló nevét a Windows operációs rendszert futtató virtuális gépen. Ez a parancsmag hozzáadja a tanúsítványt a paraméter által megadott tárolóhoz. Ezt a paramétert csak a Windows operációs rendszert futtató virtuális gépekhez adhatja meg.
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: | 2 |
| Kötelező: | False |
| 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 |
-CertificateUrl
Megadja azt az URL-címet, amely egy tanúsítványt tartalmazó Key Vault titkos kódra mutat. A tanúsítvány a következő JavaScript Object Notation (JSON) objektum Base64 kódolása, amely UTF-8-ban van kódolva: { "data": "<Base64-encoded-file>", "dataType": "<file-format>", "password": "<pfx-file-password>" } A dataType jelenleg csak .pfx fájlokat fogad el.
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: | 3 |
| Kötelező: | False |
| 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 |
-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 |
-SourceVaultId
Megadja a virtuális géphez hozzáadható tanúsítványokat tartalmazó Key Vault erőforrás-azonosítóját. Ez az érték több tanúsítvány hozzáadásának kulcsa is. Ez azt jelenti, hogy ugyanazt az értéket használhatja SourceVaultId, ha ugyanazon Key Vault több tanúsítványt is hozzáad.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Azonosító |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| 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 |
-VM
Megadja azt a virtuálisgép-objektumot, amelyet ez a parancsmag módosít. Virtuálisgép-objektum beszerzéséhez használja a Get-AzVM parancsmagot. A New-AzVMConfig parancsmaggal virtuálisgép-objektumot hozhat létre.
Paramétertulajdonságok
| Típus: | PSVirtualMachine |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | VMProfile |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| 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.