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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Count

Die angeforderte Anzahl zufälliger Bytes.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

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

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HsmName

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

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

HSM-Objekt.

Typ:PSManagedHsm
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

HSM-Ressourcen-ID.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

PSManagedHsm

Ausgaben

String

Byte