Compartilhar via

Set-SPTrustedIdentityTokenIssuer

Módulo:
SharePointServer module

Define os provedores de identidade de um aplicativo Web.

Sintaxe

ImportCertificateParameterSet 

Set-SPTrustedIdentityTokenIssuer
    [-Identity] <SPTrustedIdentityTokenIssuerPipeBind>
    -ImportTrustCertificate <X509Certificate2>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-ClaimProvider <SPClaimProviderPipeBind>]
    [-ClaimsMappings <SPClaimMappingPipeBind[]>]
    [-Description <String>]
    [-Realm <String>]
    [-SignInUrl <String>]
    [-UseWReply]
    [-Confirm]
    [-RegisteredIssuerName <String>]
    [-WhatIf]
    [<CommonParameters>]

MetadataEndPointParameterSet 

Set-SPTrustedIdentityTokenIssuer
    [-Identity] <SPTrustedIdentityTokenIssuerPipeBind>
    -MetadataEndPoint <Uri>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-ClaimProvider <SPClaimProviderPipeBind>]
    [-ClaimsMappings <SPClaimMappingPipeBind[]>]
    [-Description <String>]
    [-Realm <String>]
    [-SignInUrl <String>]
    [-UseWReply]
    [-Confirm]
    [-RegisteredIssuerName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet Set-SPTrustedIdentityTokenIssuer define os provedores de identidade de um aplicativo Web ou de um aplicativo Web estendido. No caso do provedor da Associação do ASP.NET e do provedor de Função, esse cmdlet alterará o provedor de identidade apenas se o resultado for canalizado para uma variável e passado para um aplicativo Web. Em provedores de identidade de STS (serviço de token de segurança), esse cmdlet altera o objeto do provedor de identidade persistente no objeto SPFarm.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

EXEMPLO 1

Set-SPTrustedIdentityTokenIssuer "LiveIDSTS" -Certificate (Get-ChildItem"cert:Certificates (LocalComputer)\Personal\Certificates -Name "LiveID Cert")

Este exemplo define o provedor de identidade para LiveIDSTS.

EXEMPLO 2

C:\PS>$ip = @( (Get-SPTrustedIdentityTokenIssuer "LiveID STS"), (New-SPTrustedIdentityTokenIssuer -ASPNetMembershipProvider "myMembershipProvider" -ASPNetRoleProvider "myRoleProvider"), (Get-SPTrustedIdentityTokenIssuer "NTLM")) )
New-SPWebApplication https://contoso.com -IdentityProvider $ip

Este exemplo define o provedor de identidade usando os parâmetros .ASPNetMembership e Role. Quando esses parâmetros são usados, uma variável precisa ser definida, do contrário os valores não terão efeito.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClaimProvider

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o IP STS que pode resolver e pesquisar declarações para o selecionador de pessoas de declarações.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh ou um nome válido no provedor de declarações (por exemplo, MyIDprovider1) ou uma instância de um objeto SPClaimProvider válido.

Propriedades do parâmetro

Tipo:SPClaimProviderPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ClaimsMappings

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o mapeamento de declarações do token original para o token do SharePoint.

O tipo deve ser um GUID válido no formato 12345678-90ab-cdef-1234-567890bcdefgh ou um nome válido de uma regra de mapeamento de declarações (por exemplo, Email) ou uma instância de um objeto SPClaimMapping válido.

Propriedades do parâmetro

Tipo:

SPClaimMappingPipeBind[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita a confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica uma descrição para o novo provedor de identidade.

O tipo deve ser uma cadeia de caracteres válida, por exemplo, LiveID STS.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o provedor de identidade a ser alterado.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh ou um nome válido de provedor de identidade (por exemplo, LiveID STS) ou uma instância de um objeto SPIdentityProvider.

Propriedades do parâmetro

Tipo:SPTrustedIdentityTokenIssuerPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ImportTrustCertificate

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o objeto de certificado X.509 a partir do farm de provedores de autenticação confiáveis.

O tipo deve ser o nome de um certificado X.509 válido, por exemplo Certificate1.

Propriedades do parâmetro

Tipo:X509Certificate2
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ImportCertificateParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MetadataEndPoint

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MetadataEndPointParameterSet
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Realm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o realm, ou a partição de recurso, associado a esta relação de confiança.

O tipo deve ser o nome de um território válido, por exemplo MD_REALM.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RegisteredIssuerName

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

{{Fill RegisteredIssuerName Description}}

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SignInUrl

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica as URLs de entrada desse provedor de identidade confiável STS.

The type must be a valid URL, in the form https://int.live.com/.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseWReply

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Inclui um WReply com a solicitação de token. Wreply é uma URL na terceira parte confiável para a qual o solicitante é redirecionado depois de concluído o processo de desconexão.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.