New-PartnerAccessToken

Referensi

Modul:: PartnerCenter

Memperoleh token akses dari Azure Active Directory.

Sintaks

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

Deskripsi

Memperoleh token akses dari Azure Active Directory.

Contoh

Contoh 1: Menghasilkan token akses baru

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

Perintah pertama mendapatkan kredensial perwakilan layanan (pengidentifikasi aplikasi dan rahasia perwakilan layanan), lalu menyimpannya dalam variabel $credential. Perintah kedua akan meminta token akses baru dari Azure Active Directory. Saat menggunakan parameter UseAuthorizationCode, Anda akan diminta untuk melakukan autentikasi secara interaktif menggunakan alur kode otorisasi. Nilai URI pengalihan akan dihasilkan secara dinamis. Proses generasi ini akan mencoba menemukan port antara 8400 dan 8999 yang tidak digunakan. Setelah port yang tersedia ditemukan, nilai URL pengalihan akan dibangun (misalnya http://localhost:8400). Jadi, penting bagi Anda untuk mengonfigurasi nilai URI pengalihan untuk aplikasi Azure Active Directory Anda.

Contoh 2: Membuat token akses menggunakan token refresh

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'

Perintah pertama mendapatkan kredensial perwakilan layanan (pengidentifikasi aplikasi dan rahasia perwakilan layanan), lalu menyimpannya dalam variabel $credential. Perintah ketiga akan menghasilkan token akses baru menggunakan kredensial perwakilan layanan yang disimpan dalam variabel $credential dan token refresh yang disimpan dalam variabel $refreshToken untuk autentikasi.

Parameter

-AccessToken

Token akses untuk Pusat Mitra.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ApplicationId

Pengidentifikasi aplikasi yang akan digunakan selama autentikasi.

Jenis:	String
Alias:	ClientId
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-CertificateThumbprint

Hash Sertifikat (Thumbprint)

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Credential

Kredensial yang mewakili perwakilan layanan.

Jenis:	PSCredential
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Environment

Lingkungan digunakan untuk autentikasi.

Jenis:	EnvironmentName
Alias:	EnvironmentName
Nilai yang diterima:	AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-Module

Modul yang dibuat oleh token akses.

Jenis:	ModuleName
Alias:	ModuleName
Nilai yang diterima:	ExchangeOnline, ExchangeOnline
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-RefreshToken

Token refresh yang akan digunakan selama autentikasi.

Jenis:	String
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Scopes

Cakupan yang diminta untuk mengakses API yang dilindungi.

Jenis:	String[]
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-ServicePrincipal

Menunjukkan bahwa akun ini mengautentikasi dengan memberikan kredensial perwakilan layanan.

Jenis:	SwitchParameter
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-Tenant

Pengidentifikasi penyewa Azure ACTIVE Directory.

Jenis:	String
Alias:	Domain, TenantId
Position:	Named
Nilai default:	None
Diperlukan:	True
Terima input alur:	False
Terima karakter wildcard:	False

-UseAuthorizationCode

Gunakan alur kode otorisasi selama autentikasi.

Jenis:	SwitchParameter
Alias:	AuthCode
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

-UseDeviceAuthentication

Menggunakan autentikasi kode perangkat alih-alih kontrol browser

Jenis:	SwitchParameter
Alias:	DeviceCode, DeviceAuth, Device
Position:	Named
Nilai default:	None
Diperlukan:	False
Terima input alur:	False
Terima karakter wildcard:	False

Input

None

Output

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

Bagikan melalui