Share via


Get-AzKeyVaultRandomNumber

Rufen Sie die angeforderte Anzahl von Bytes ab, die Zufallswerte aus einem verwalteten HSM enthalten.

Syntax

Get-AzKeyVaultRandomNumber
   [-DefaultProfile <IAzureContextContainer>]
   [-HsmName] <String>
   -Count <Int32>
   [-AsBase64String]
   [<CommonParameters>]
Get-AzKeyVaultRandomNumber
   [-ResourceId] <String>
   [-DefaultProfile <IAzureContextContainer>]
   -Count <Int32>
   [-AsBase64String]
   [<CommonParameters>]
Get-AzKeyVaultRandomNumber
   [-DefaultProfile <IAzureContextContainer>]
   [-InputObject] <PSManagedHsm>
   -Count <Int32>
   [-AsBase64String]
   [<CommonParameters>]

Beschreibung

Rufen Sie die angeforderte Anzahl von Bytes ab, die Zufallswerte aus einem verwalteten HSM enthalten.

Beispiele

Beispiel 1: Abrufen der angeforderten Anzahl zufälliger Bytes durch verwalteten HSM-Namen

Get-AzKeyVaultRandomNumber -HsmName testmhsm -Count 10

158
171
96
142
109
28
1
85
178
201

Dieser Befehl ruft 10 zufällige Bytes von verwaltetem HSM "testmhsm" ab.

Beispiel 2: Abrufen einer Zufallszahl als base64-Zeichenfolge durch Piping

Get-AzKeyVaultManagedHsm -HsmName bezmhsm2022 | Get-AzKeyVaultRandomNumber -Count 10 -AsBase64String

G1CsEqa9yUp/EA==

Dieser Befehl ruft 10 zufällige Bytes als Base64-Zeichenfolge von verwaltetem HSM "testmhsm" ab.

Beispiel 3: Zufallszahl nach Ressourcen-ID abrufen

Get-AzKeyVaultRandomNumber -ResourceId /subscriptions/0b1fxxxx-xxxx-xxxx-aec3-xxxx72f09590/resourceGroups/test-rg/provders/Microsoft.KeyVault/managedHSMs/testhsm -Count 10

158
171
96
142
109
28
1
85
178
201

Dieser Befehl ruft 10 zufällige Bytes von verwaltetem HSM mit angegebener Ressourcen-ID ab.

Parameter

-AsBase64String

Wenn angegeben, geben Sie Zufallszahl als Basis-64-Ziffer zurück. Standardmäßig wird mit diesem Befehl die Zufallszahl als Bytearray neu geordnet.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Count

Die angeforderte Anzahl zufälliger Bytes.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-HsmName

HSM-Name. Cmdlet erstellt den FQDN eines verwalteten HSM basierend auf dem Namen und der aktuell ausgewählten Umgebung.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

HSM-Objekt.

Type:PSManagedHsm
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

HSM-Ressourcen-ID.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

PSManagedHsm

Ausgaben

String

Byte