New-PartnerAccessToken

Module:

PartnerCenter

Krijgt een toegangstoken van Azure Active Directory.

Syntaxis

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

Description

Krijgt een toegangstoken van Azure Active Directory.

Voorbeelden

Voorbeeld 1: Een nieuw toegangstoken genereren

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

Met de eerste opdracht worden de referenties van de service-principal opgehaald (toepassings-id en geheim van de service-principal) en worden deze vervolgens opgeslagen in de $credential variabele. Met de tweede opdracht wordt een nieuw toegangstoken aangevraagd vanuit Azure Active Directory. Wanneer u de parameter UseAuthorizationCode gebruikt, wordt u gevraagd om interactief te verifiëren met behulp van de autorisatiecodestroom. De omleidings-URI-waarde wordt dynamisch gegenereerd. Dit generatieproces probeert een poort te vinden tussen 8400 en 8999 die niet in gebruik is. Zodra er een beschikbare poort is gevonden, wordt de waarde van de omleidings-URL samengesteld (bijvoorbeeld http://localhost:8400). Het is dus belangrijk dat u de omleidings-URI-waarde voor uw Azure Active Directory-toepassing dienovereenkomstig hebt geconfigureerd.

Voorbeeld 2: Een toegangstoken genereren met behulp van een vernieuwingstoken

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'

Met de eerste opdracht worden de referenties van de service-principal opgehaald (toepassings-id en geheim van de service-principal) en worden deze vervolgens opgeslagen in de $credential variabele. Met de derde opdracht wordt een nieuw toegangstoken gegenereerd met behulp van de referenties van de service-principal die zijn opgeslagen in de $credential variabele en het vernieuwingstoken dat is opgeslagen in de $refreshToken variabele voor verificatie.

Parameters

-AccessToken

Het toegangstoken voor partnercentrum.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ApplicationId

De toepassings-id die moet worden gebruikt tijdens de verificatie.

Type:	String
Aliassen:	ClientId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-CertificateThumbprint

Certificaat-hash (vingerafdruk)

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Credential

Referenties die de service-principal vertegenwoordigen.

Type:	PSCredential
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Environment

De omgeving die wordt gebruikt voor verificatie.

Type:	EnvironmentName
Aliassen:	EnvironmentName
Geaccepteerde waarden:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Module

De module die een toegangstoken genereert.

Type:	ModuleName
Aliassen:	ModuleName
Geaccepteerde waarden:	ExchangeOnline, ExchangeOnline
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RefreshToken

Het vernieuwingstoken dat moet worden gebruikt tijdens verificatie.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Scopes

Bereiken die zijn aangevraagd voor toegang tot een beveiligde API.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-ServicePrincipal

Geeft aan dat dit account wordt geverifieerd door referenties voor de service-principal op te geven.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Tenant

De id van de Azure AD-tenant.

Type:	String
Aliassen:	Domain, TenantId
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UseAuthorizationCode

Gebruik de autorisatiecodestroom tijdens verificatie.

Type:	SwitchParameter
Aliassen:	AuthCode
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-UseDeviceAuthentication

Verificatie van apparaatcode gebruiken in plaats van een browserbesturing

Type:	SwitchParameter
Aliassen:	DeviceCode, DeviceAuth, Device
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Uitvoerwaarden

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