New-PartnerAccessToken

Модуль:
PartnerCenter Module

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

Синтаксис

AccessToken 

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

RefreshToken 

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

ServicePrincipal 

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

ServicePrincipalCertificate 

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

User 

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

ByModule 

New-PartnerAccessToken
    -Module <ModuleName>
    [-Environment <EnvironmentName>]
    [-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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccessToken
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ApplicationId

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ClientId

Наборы параметров

AccessToken
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipal
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipalCertificate
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
User
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-CertificateThumbprint

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RefreshToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Credential

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

Свойства параметра

Тип:PSCredential
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccessToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RefreshToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Environment

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

Свойства параметра

Тип:EnvironmentName
Default value:None
Допустимые значения:AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Имя среды

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Module

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

Свойства параметра

Тип:ModuleName
Default value:None
Допустимые значения:ExchangeOnline
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Имя модуля

Наборы параметров

RefreshToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RefreshToken

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RefreshToken
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Scopes

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

AccessToken
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RefreshToken
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipal
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipalCertificate
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
User
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ServicePrincipal

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

RefreshToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipalCertificate
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Tenant

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Домен, Идентификатор арендатора (TenantId)

Наборы параметров

AccessToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
RefreshToken
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
User
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ByModule
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UseAuthorizationCode

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Код авторизации

Наборы параметров

ServicePrincipal
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ServicePrincipalCertificate
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
User
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False
ByModule
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UseDeviceAuthentication

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:DeviceCode, DeviceAuth, Устройство

Наборы параметров

User
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

None

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

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