New-PartnerAccessToken

Referens

Modul:: PartnerCenter

Hämtar en åtkomsttoken från Azure Active Directory.

Syntax

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

Hämtar en åtkomsttoken från Azure Active Directory.

Exempel

Exempel 1: Generera en ny åtkomsttoken

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

Det första kommandot hämtar autentiseringsuppgifterna för tjänstens huvudnamn (programidentifierare och tjänstens huvudhemlighet) och lagrar dem sedan i variabeln $credential. Det andra kommandot begär en ny åtkomsttoken från Azure Active Directory. När du använder parametern UseAuthorizationCode uppmanas du att autentisering interaktivt med hjälp av auktoriseringskodflödet. Omdirigerings-URI-värdet genereras dynamiskt. Den här genereringsprocessen försöker hitta en port mellan 8400 och 8999 som inte används. När en tillgänglig port har hittats skapas omdirigerings-URL-värdet (t.ex. http://localhost:8400). Därför är det viktigt att du har konfigurerat omdirigerings-URI-värdet för ditt Azure Active Directory-program i enlighet med detta.

Exempel 2: Generera en åtkomsttoken med en uppdateringstoken

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'

Det första kommandot hämtar autentiseringsuppgifterna för tjänstens huvudnamn (programidentifierare och tjänstens huvudhemlighet) och lagrar dem sedan i variabeln $credential. Det tredje kommandot genererar en ny åtkomsttoken med autentiseringsuppgifterna för tjänstens huvudnamn som lagras i variabeln $credential och uppdateringstoken som lagras i variabeln $refreshToken för autentisering.

Parametrar

-AccessToken

Åtkomsttoken för Partnercenter.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ApplicationId

Programidentifieraren som ska användas under autentiseringen.

Typ:	String
Alias:	ClientId
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-CertificateThumbprint

Certifikathash (tumavtryck)

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Credential

Autentiseringsuppgifter som representerar tjänstens huvudnamn.

Typ:	PSCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Environment

Miljön används för autentisering.

Typ:	EnvironmentName
Alias:	EnvironmentName
Godkända värden:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Module

Modulen som en åtkomsttoken genereras.

Typ:	ModuleName
Alias:	ModuleName
Godkända värden:	ExchangeOnline, ExchangeOnline
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RefreshToken

Uppdateringstoken som ska användas under autentiseringen.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Scopes

Omfång som begärs för åtkomst till ett skyddat API.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-ServicePrincipal

Anger att det här kontot autentiserar genom att ange autentiseringsuppgifter för tjänstens huvudnamn.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Tenant

Identifieraren för Azure AD-klientorganisationen.

Typ:	String
Alias:	Domain, TenantId
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UseAuthorizationCode

Använd auktoriseringskodflödet under autentiseringen.

Typ:	SwitchParameter
Alias:	AuthCode
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-UseDeviceAuthentication

Använda enhetskodautentisering i stället för en webbläsarkontroll

Typ:	SwitchParameter
Alias:	DeviceCode, DeviceAuth, Device
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

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

Dela via