New-PartnerAccessToken

Referenz

Modul:: PartnerCenter

Erwirbt ein Zugriffstoken aus 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>]

Beschreibung

Erwirbt ein Zugriffstoken aus Azure Active Directory.

Beispiele

Beispiel 1: Generieren eines neuen Zugriffstokens

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

Der erste Befehl ruft die Dienstprinzipalanmeldeinformationen (Anwendungsbezeichner und Dienstprinzipalschlüssel) ab und speichert sie dann in der variablen $credential. Der zweite Befehl fordert ein neues Zugriffstoken aus Azure Active Directory an. Wenn Sie den parameter UseAuthorizationCode verwenden, werden Sie mithilfe des Autorisierungscodeflusses interaktiv zur Authentifizierung aufgefordert. Der Umleitungs-URI-Wert wird dynamisch generiert. Dieser Generierungsprozess versucht, einen Port zwischen 8400 und 8999 zu finden, der nicht verwendet wird. Sobald ein verfügbarer Port gefunden wurde, wird der Umleitungs-URL-Wert erstellt (z. B. http://localhost:8400). Daher ist es wichtig, dass Sie den Umleitungs-URI-Wert für Ihre Azure Active Directory-Anwendung entsprechend konfiguriert haben.

Beispiel 2: Generieren eines Zugriffstokens mithilfe eines Aktualisierungstokens

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'

Der erste Befehl ruft die Dienstprinzipalanmeldeinformationen (Anwendungsbezeichner und Dienstprinzipalschlüssel) ab und speichert sie dann in der variablen $credential. Der dritte Befehl generiert ein neues Zugriffstoken mit den in der $credential Variablen $credential variablen gespeicherten Dienstprinzipalanmeldeinformationen und dem Aktualisierungstoken, das in der $refreshToken Variablen für die Authentifizierung gespeichert ist.

Parameter

-AccessToken

Das Zugriffstoken für Partner Center.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ApplicationId

Der Anwendungsbezeichner, der während der Authentifizierung verwendet werden soll.

Typ:	String
Aliase:	ClientId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CertificateThumbprint

Zertifikathash (Fingerabdruck)

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Anmeldeinformationen, die den Dienstprinzipal darstellen.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Environment

Die Umgebung, die für die Authentifizierung verwendet wird.

Typ:	EnvironmentName
Aliase:	EnvironmentName
Zulässige Werte:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Module

Das Modul, das ein Zugriffstoken generiert wird.

Typ:	ModuleName
Aliase:	ModuleName
Zulässige Werte:	ExchangeOnline, ExchangeOnline
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RefreshToken

Das Während der Authentifizierung zu verwendende Aktualisierungstoken.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scopes

Bereiche, die für den Zugriff auf eine geschützte API angefordert wurden.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServicePrincipal

Gibt an, dass sich dieses Konto authentifiziert, indem Dienstprinzipalanmeldeinformationen bereitgestellt werden.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Tenant

Der Bezeichner des Azure AD-Mandanten.

Typ:	String
Aliase:	Domain, TenantId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UseAuthorizationCode

Verwenden Sie den Autorisierungscodefluss während der Authentifizierung.

Typ:	SwitchParameter
Aliase:	AuthCode
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UseDeviceAuthentication

Verwenden der Gerätecodeauthentifizierung anstelle eines Browsersteuerelements

Typ:	SwitchParameter
Aliase:	DeviceCode, DeviceAuth, Device
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Ausgaben

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

Freigeben über