Get-AzKeyVaultRandomNumber

Ottenere il numero richiesto di byte contenenti valori casuali da un modulo di protezione hardware gestito.

Sintassi

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>]

Descrizione

Ottenere il numero richiesto di byte contenenti valori casuali da un modulo di protezione hardware gestito.

Esempio

Esempio 1: Ottenere il numero richiesto di byte casuali in base al nome del modulo di protezione hardware gestito

Get-AzKeyVaultRandomNumber -HsmName testmhsm -Count 10

158
171
96
142
109
28
1
85
178
201

Questo comando ottiene 10 byte casuali dal modulo di protezione hardware gestito "testmhsm"

Esempio 2: Ottenere un numero casuale come stringa base64 tramite piping

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

G1CsEqa9yUp/EA==

Questo comando ottiene 10 byte casuali come stringa base 64 dal modulo di protezione hardware gestito "testmhsm"

Esempio 3: Ottenere un numero casuale in base all'ID risorsa

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

Questo comando ottiene 10 byte casuali dal modulo di protezione hardware gestito con ID risorsa specificato

Parametri

-AsBase64String

Se specificato, restituisce un numero casuale come cifra base 64. Per impostazione predefinita, questo comando restituisce un numero casuale come matrice di byte.

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

-Count

Numero richiesto di byte casuali.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-HsmName

Nome HSM. Il cmdlet costruisce il nome di dominio completo di un modulo di protezione hardware gestito in base al nome e all'ambiente attualmente selezionato.

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

-InputObject

Oggetto HSM.

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

-ResourceId

ID risorsa HSM.

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

Input

String

PSManagedHsm

Output

String

Byte