你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzKeyVaultRandomNumber

从托管 HSM 获取包含随机值的请求字节数。

语法

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

说明

从托管 HSM 获取包含随机值的请求字节数。

示例

示例 1:按托管 HSM 名称获取请求的随机字节数

Get-AzKeyVaultRandomNumber -HsmName testmhsm -Count 10

158
171
96
142
109
28
1
85
178
201

此命令从托管 HSM “testmhsm” 获取 10 个随机字节

示例 2:通过管道获取随机数作为 base64 字符串

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

G1CsEqa9yUp/EA==

此命令从托管 HSM “testmhsm” 获取 10 个随机字节作为 base-64 字符串

示例 3:按资源 ID 获取随机数

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

此命令从具有指定资源 ID 的托管 HSM 获取 10 个随机字节

参数

-AsBase64String

如果指定,则返回随机数作为 base-64 数字。 默认情况下,此命令将随机数重新构造为字节数组。

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

-Count

请求的随机字节数。

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

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

-HsmName

HSM 名称。 Cmdlet 基于名称和当前所选环境构造托管 HSM 的 FQDN。

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

-InputObject

HSM 对象。

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

-ResourceId

HSM 资源 ID。

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

输入

String

PSManagedHsm

输出

String

Byte