New-PartnerAccessToken

Ссылка

Модуль:: PartnerCenter

Получает маркер доступа из Azure Active Directory.

Синтаксис

New-PartnerAccessToken
   -AccessToken <String>
   -ApplicationId <String>
   [-Credential <PSCredential>]
   [-Environment <EnvironmentName>]
   -Scopes <String[]>
   [-Tenant <String>]
   [<CommonParameters>]

New-PartnerAccessToken
   [-ApplicationId <String>]
   [-CertificateThumbprint <String>]
   [-Credential <PSCredential>]
   [-Environment <EnvironmentName>]
   [-Module <ModuleName>]
   -RefreshToken <String>
   -Scopes <String[]>
   [-ServicePrincipal]
   [-Tenant <String>]
   [<CommonParameters>]

New-PartnerAccessToken
   -ApplicationId <String>
   -Credential <PSCredential>
   [-Environment <EnvironmentName>]
   -Scopes <String[]>
   [-ServicePrincipal]
   -Tenant <String>
   [-UseAuthorizationCode]
   [<CommonParameters>]

New-PartnerAccessToken
   -ApplicationId <String>
   -CertificateThumbprint <String>
   [-Environment <EnvironmentName>]
   -Scopes <String[]>
   [-ServicePrincipal]
   -Tenant <String>
   [-UseAuthorizationCode]
   [<CommonParameters>]

New-PartnerAccessToken
   -ApplicationId <String>
   [-Environment <EnvironmentName>]
   -Scopes <String[]>
   [-Tenant <String>]
   [-UseAuthorizationCode]
   [-UseDeviceAuthentication]
   [<CommonParameters>]

New-PartnerAccessToken
   [-Environment <EnvironmentName>]
   -Module <ModuleName>
   [-RefreshToken <String>]
   [-Tenant <String>]
   [-UseAuthorizationCode]
   [<CommonParameters>]

Описание

Получает маркер доступа из Azure Active Directory.

Примеры

Пример 1. Создание нового маркера доступа

PS C:\> $credential = Get-Credential
PS C:\> New-PartnerAccessToken -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -Scopes 'https://api.partnercenter.microsoft.com/user_impersonation' -ServicePrincipal -Credential $credential -Tenant 'xxxx-xxxx-xxxx-xxxx' -UseAuthorizationCode

Первая команда получает учетные данные субъекта-службы (идентификатор приложения и секрет субъекта-службы), а затем сохраняет их в переменной $credential. Вторая команда запрашивает новый маркер доступа из Azure Active Directory. При использовании параметра UseAuthorizationCode вам будет предложено выполнить проверку подлинности в интерактивном режиме с помощью потока кода авторизации. Значение URI перенаправления будет создаваться динамически. Этот процесс создания попытается найти порт от 8400 до 8999, который не используется. После обнаружения доступного порта будет создано значение URL-адреса перенаправления (например, http://localhost:8400). Поэтому важно настроить значение URI перенаправления для приложения Azure Active Directory соответствующим образом.

Пример 2. Создание маркера доступа с помощью маркера обновления

PS C:\> $credential = Get-Credential
PS C:\> $refreshToken = '<refreshToken>'
PS C:\> New-PartnerAccessToken -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -Credential $credential -RefreshToken $refreshToken -Scopes 'https://api.partnercenter.microsoft.com/user_impersonation' -ServicePrincipal -Tenant 'xxxx-xxxx-xxxx-xxxx'

Первая команда получает учетные данные субъекта-службы (идентификатор приложения и секрет субъекта-службы), а затем сохраняет их в переменной $credential. Третья команда создаст новый маркер доступа с помощью учетных данных субъекта-службы, хранящихся в переменной $credential, и маркер обновления, хранящийся в переменной $refreshToken для проверки подлинности.

Параметры

-AccessToken

Маркер доступа для Центра партнеров.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationId

Идентификатор приложения, используемый во время проверки подлинности.

Тип:	String
Aliases:	ClientId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-CertificateThumbprint

Хэш сертификата (отпечаток)

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Credential

Учетные данные, представляющие субъект-службу.

Тип:	PSCredential
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Environment

Среда, используемая для проверки подлинности.

Тип:	EnvironmentName
Aliases:	EnvironmentName
Допустимые значения:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Module

Модуль, созданный маркером доступа.

Тип:	ModuleName
Aliases:	ModuleName
Допустимые значения:	ExchangeOnline, ExchangeOnline
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RefreshToken

Маркер обновления, используемый во время проверки подлинности.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Scopes

Области, запрошенные для доступа к защищенному API.

Тип:	String[]
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ServicePrincipal

Указывает, что эта учетная запись проходит проверку подлинности, предоставляя учетные данные субъекта-службы.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Tenant

Идентификатор клиента Azure AD.

Тип:	String
Aliases:	Domain, TenantId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UseAuthorizationCode

Используйте поток кода авторизации во время проверки подлинности.

Тип:	SwitchParameter
Aliases:	AuthCode
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UseDeviceAuthentication

Использование проверки подлинности кода устройства вместо элемента управления браузером

Тип:	SwitchParameter
Aliases:	DeviceCode, DeviceAuth, Device
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

None

Выходные данные

Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.AuthResult

Поделиться через