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

Get-AzAccessToken

获取安全的原始访问令牌。 使用 -ResourceUrl 时,请确保该值与当前的 Azure 环境匹配。 可以引用 (Get-AzContext).Environment的值。

注意: 当前默认输出令牌类型将从纯文本 String 更改为 SecureString,以确保安全性。 请在重大更改生效之前使用 -AsSecureString 迁移到安全行为。

语法

Get-AzAccessToken
   [-ResourceTypeName <String>]
   [-TenantId <String>]
   [-AsSecureString]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzAccessToken
   -ResourceUrl <String>
   [-TenantId <String>]
   [-AsSecureString]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

获取访问令牌

示例

示例 1 获取 ARM 终结点的访问令牌

Get-AzAccessToken -AsSecureString

获取 ResourceManager 终结点的当前帐户的访问令牌

示例 2 获取 Microsoft Graph 终结点的访问令牌

Get-AzAccessToken -AsSecureString -ResourceTypeName MSGraph

获取当前帐户的 Microsoft Graph 终结点的访问令牌

示例 3 获取 Microsoft Graph 终结点的访问令牌

Get-AzAccessToken -AsSecureString -ResourceUrl "https://graph.microsoft.com/"

获取当前帐户的 Microsoft Graph 终结点的访问令牌

参数

-AsSecureString

将输出令牌转换为安全字符串的规范。 请始终将参数用于安全目的,并避免即将中断的常量,并参阅有关 Azure PowerShell 的 常见问题,了解如何从 转换为纯文本。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzContext, AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceTypeName

可选资源类型名称,支持的值:AadGraph、AnalysisServices、AppConfiguration、Arm、证明、Batch、CommunicationEmail、DataLake、KeyVault、MSGraph、OperationalInsights、ResourceManager、Storage、Synapse。 默认值为 Arm(如果未指定)。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceUrl

请求令牌的资源 URL,例如“https://graph.microsoft.com/”。

类型:String
别名:Resource, ResourceUri
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TenantId

可选租户 ID。如果未指定,请使用默认上下文的租户 ID。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

None

输出

PSAccessToken

输出类型将弃用。

PSSecureAccessToken

使用 -AsSecureString 获取令牌作为 SecureString