Partager via


Connect-PartnerCenter

Connectez-vous à l’Espace partenaires avec un compte authentifié pour une utilisation avec les demandes d’applet de commande partenaire.

Syntaxe

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

Description

L’applet de commande Connect-PartnerCenter se connecte à l’Espace partenaires avec un compte authentifié à utiliser avec les demandes d’applet de commande partenaire. Après avoir exécuté cette applet de commande, vous pouvez vous déconnecter d’un compte Espace partenaires à l’aide de Disconnect-PartnerCenter.

Exemples

Exemple 1

PS C:\> Connect-PartnerCenter

Cette commande se connecte à un compte espace partenaires. Pour exécuter des applets de commande partenaires avec ce compte, vous devez fournir des informations d’identification organisationnelles, associées au programme Fournisseur de solutions cloud, à l’invite.

Exemple 2

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

La première commande obtient les informations d’identification du principal de service (identificateur d’application et secret du principal de service), puis les stocke dans la variable $credential. La deuxième commande se connecte à l’Espace partenaires à l’aide des informations d’identification du principal de service stockées dans $credential pour le locataire spécifié. Le paramètre de commutateur ServicePrincipal indique que le compte s’authentifie en tant que principal de service.

Exemple 3

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

Se connecte à l’Espace partenaires à l’aide d’un jeton d’actualisation généré à l’aide d’une application native .

Exemple 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

Se connecte à l’Espace partenaires à l’aide d’un jeton d’actualisation généré à l’aide d’une application web .

Paramètres

-AccessToken

Jeton d’accès pour l’Espace partenaires.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ApplicationId

SPN

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CertificateThumbprint

Hachage de certificat (empreinte numérique)

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Credential

Identificateur d’application et secret pour les informations d’identification du principal de service.

Type:PSCredential
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Environment

Environnement contenant le compte à connecter.

Type:EnvironmentName
Valeurs acceptées:AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RefreshToken

Jeton d’actualisation utilisé pour se connecter à l’Espace partenaires.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ServicePrincipal

Indique que ce compte s’authentifie en fournissant les informations d’identification du principal de service.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Tenant

Identificateur du locataire Azure AD.

Type:String
Alias:Domain, TenantId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UseDeviceAuthentication

Utiliser l’authentification par code d’appareil au lieu d’un contrôle de navigateur

Type:SwitchParameter
Alias:Device, DeviceAuth, DeviceCode
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

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