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

Get-AzAccessToken

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

注释

出于安全考虑,默认输出类型已从纯文本 String 更改为 SecureString。 有关详细信息,请参阅保护 Azure PowerShell 中的机密

语法

KnownResourceTypeName (默认值)

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

ResourceUrl

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

参数不再使用,但为了向后兼容而保留。 无论 AsSecureString 指定什么,输出令牌都是一个 SecureString

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceTypeName

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

KnownResourceTypeName
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceUrl

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:资源, ResourceUri

参数集

ResourceUrl
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TenantId

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

PSSecureAccessToken