Partilhar via


Connect-PartnerCenter

Conecte-se ao Partner Center com uma conta autenticada para uso com solicitações de cmdlets de parceiros.

Sintaxe

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

O cmdlet Connect-PartnerCenter se conecta ao Partner Center com uma conta autenticada para uso com solicitações de cmdlet de parceiro. Depois de executar esse cmdlet, você pode se desconectar de uma conta do Partner Center usando Disconnect-PartnerCenter.

Exemplos

Exemplo 1

PS C:\> Connect-PartnerCenter

Este comando liga-se a uma conta do Partner Center. Para executar cmdlets de parceiros com essa conta, você deve fornecer credenciais organizacionais, associadas ao programa Provedor de Soluções na Nuvem, no prompt.

Exemplo 2

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

O primeiro comando obtém as credenciais da entidade de serviço (identificador do aplicativo e segredo da entidade de serviço) e, em seguida, armazena-as na variável $credential. O segundo comando se conecta ao Partner Center usando as credenciais da entidade de serviço armazenadas no $credential para o Locatário especificado. O parâmetro de opção ServicePrincipal indica que a conta é autenticada como uma entidade de serviço.

Exemplo 3

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

Conecta-se ao Partner Center usando um token de atualização que foi gerado usando um aplicativo nativo .

Exemplo 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

Conecta-se ao Partner Center usando um token de atualização que foi gerado usando um aplicativo Web .

Parâmetros

-AccessToken

O token de acesso para o Partner Center.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ApplicationId

SPN

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CertificateThumbprint

Hash do certificado (impressão digital)

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Identificador de aplicativo e segredo para credenciais da entidade de serviço.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Environment

Ambiente que contém a conta para iniciar sessão.

Tipo:EnvironmentName
Valores aceites:AzureCloud, AzureChinaCloud, AzureGermanCloud, AzurePPE, AzureUSGovernment
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RefreshToken

Token de atualização usado para se conectar ao Partner Center.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ServicePrincipal

Indica que essa conta é autenticada fornecendo credenciais da entidade de serviço.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Tenant

O identificador do locatário do Azure AD.

Tipo:String
Aliases:Domain, TenantId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UseDeviceAuthentication

Usar autenticação de código de dispositivo em vez de um controle de navegador

Tipo:SwitchParameter
Aliases:Device, DeviceAuth, DeviceCode
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

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