Condividi tramite


Connect-PartnerCenter

Connettersi al Centro per i partner con un account autenticato da usare con le richieste di cmdlet dei partner.

Sintassi

Connect-PartnerCenter
       [-Environment <EnvironmentName>]
       [-Tenant <String>]
       [-UseDeviceAuthentication]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-PartnerCenter
       -AccessToken <String>
       [-Environment <EnvironmentName>]
       [-Tenant <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-PartnerCenter
       -ApplicationId <String>
       [-CertificateThumbprint <String>]
       [-Credential <PSCredential>]
       [-Environment <EnvironmentName>]
       -RefreshToken <String>
       [-Tenant <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-PartnerCenter
       -ApplicationId <String>
       -CertificateThumbprint <String>
       [-Environment <EnvironmentName>]
       [-ServicePrincipal]
       -Tenant <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Connect-PartnerCenter
       -Credential <PSCredential>
       [-Environment <EnvironmentName>]
       [-ServicePrincipal]
       -Tenant <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il cmdlet Connect-PartnerCenter si connette al Centro per i partner con un account autenticato da usare con le richieste dei cmdlet partner. Dopo aver eseguito questo cmdlet, è possibile disconnettersi da un account del Centro per i partner usando Disconnect-PartnerCenter.

Esempio

Esempio 1

PS C:\> Connect-PartnerCenter

Questo comando si connette a un account del Centro per i partner. Per eseguire i cmdlet dei partner con questo account, è necessario specificare le credenziali dell'organizzazione associate al programma Cloud Solution Provider al prompt.

Esempio 2

PS C:\> $credential = Get-Credential
PS C:\> Connect-PartnerCenter -Credential $credential -Tenant 'xxxx-xxxx-xxxx-xxxx' -ServicePrincipal

Il primo comando ottiene le credenziali dell'entità servizio (identificatore dell'applicazione e segreto dell'entità servizio) e quindi le archivia nella variabile $credential. Il secondo comando si connette al Centro per i partner usando le credenziali dell'entità servizio archiviate in $credential per il tenant specificato. Il parametro switch ServicePrincipal indica che l'account viene autenticato come entità servizio.

Esempio 3

PS C:\> $refreshToken = '<refreshToken>'
PS C:\> Connect-PartnerCenter -ApplicationId 'xxxx-xxxx-xxxx-xxxx' -RefreshToken $refreshToken

Si connette al Centro per i partner usando un token di aggiornamento generato usando un'applicazione nativa .

Esempio 4

PS C:\> $appId = 'xxxx-xxxx-xxxx-xxxx'
PS C:\> $secret =  ConvertTo-SecureString 'app-secret-here' -AsPlainText -Force
PS C:\> $refreshToken = '<refreshToken>'
PC C:\> $tenantId = 'yyyy-yyyy-yyyy-yyyy'
PS C:\>
PS C:\> $credential = New-Object System.Management.Automation.PSCredential($appId, $secret)
PS C:\>
PS C:\> Connect-PartnerCenter -ApplicationId $appId -Credential $credential -RefreshToken $refreshToken

Si connette al Centro per i partner usando un token di aggiornamento generato usando un'applicazione Web .

Parametri

-AccessToken

Token di accesso per il Centro per i partner.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationId

SPN

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CertificateThumbprint

Hash del certificato (identificazione personale)

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Credential

Identificatore dell'applicazione e segreto per le credenziali dell'entità servizio.

Tipo:PSCredential
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Environment

Ambiente contenente l'account a cui accedere.

Tipo:EnvironmentName
Valori accettati:AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RefreshToken

Token di aggiornamento usato per connettersi al Centro per i partner.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ServicePrincipal

Indica che questo account viene autenticato fornendo le credenziali dell'entità servizio.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tenant

Identificatore del tenant di Azure AD.

Tipo:String
Alias:Domain, TenantId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UseDeviceAuthentication

Usare l'autenticazione del codice del dispositivo anziché un controllo del browser

Tipo:SwitchParameter
Alias:Device, DeviceAuth, DeviceCode
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

Microsoft.Store.PartnerCenter.PowerShell.Models.Authentication.PartnerContext