Set-SPODataConnectionSetting

  • Referência
Módulo:
Microsoft.Online.SharePoint.PowerShell
Aplica-se a:
SharePoint Server 2013, SharePoint Server 2016

Define ou atualiza as propriedades globais para uma conexão dos Serviços Corporativos de Conectividade da Microsoft.

Syntax

Set-SPODataConnectionSetting
   [-Identity] <ODataConnectionSettings>
   -ServiceContext <SPServiceContextPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMode <ODataAuthenticationMode>]
   [-Confirm]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [-ServiceAddressURL <Uri>]
   [-WhatIf]
   [<CommonParameters>]
Set-SPODataConnectionSetting
   -ServiceContext <SPServiceContextPipeBind>
   -Name <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AuthenticationMode <ODataAuthenticationMode>]
   [-Confirm]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [-ServiceAddressURL <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

Use o cmdlet Set-SPODataConnectionSetting para atualizar as propriedades de uma conexão existente para um aplicativo de serviço específico dos Serviços Corporativos de Conectividade.

Este cmdlet aplica-se apenas de um ambiente no local. Você não pode usar este comando no SharePoint Online Management Shell.

Para obter as permissões e informações mais atuais sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251831 (https://go.microsoft.com/fwlink/p/?LinkId=251831).

Exemplos

-------------EXEMPLO 1-----------

Set-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -AuthenticationMode "PassThrough"

Este exemplo atualiza as propriedades da conexão dos Serviços Corporativos de Conectividade denominada ContosoServiceApp.

-------------EXEMPLO 2-----------

$ConnectionVariable = Get-SPODataConnectionSetting -ServiceContext http://contoso -Name "ContosoServiceApp"

Set-SPODataConnectionSetting -Identity $ConnectionVariable -AuthenticationMode "PassThrough"

Este exemplo atualiza as propriedades da conexão de serviço dos Serviços Corporativos de Conectividade denominada ContosoServiceApp.

-------------EXEMPLO 3-----------

Set-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -AuthenticationMode "PassThrough" -ExtensionProvider ""

Este exemplo atualiza as propriedades da conexão do Serviços Corporativos de Conectividade denominada ContosoServiceApp, o modo de autenticação foi alterado e o valor do provedor de extensão foi apagado.

Parâmetros

-AssignmentCollection

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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-AuthenticationMode

Especifica o tipo de modo de autenticação exigido para a conexão Serviços Corporativos de Conectividade.

O valor para o modo de autenticação é uma das seguintes opções:

--PassThrough --RevertToSelf --Credentials --WindowsCredentials --DigestCredentials --ClientCertificate --Anonymous

Type:ODataAuthenticationMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Confirm

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-ExtensionProvider

Especifica o ODataExtensionProvider da conexão dos Serviços Corporativos de Conectividade.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Identity

Especifica o objeto OData Connection Settings.

Type:ODataConnectionSettings
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-Name

Especifica o nome da conexão existente dos Serviços Corporativos de Conectividade.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-SecureStoreTargetApplicationId

Especifica o ID do Aplicativo de Destino do Repositório Seguro. Trabalha em conjunto com o parâmetro AuthenticationMode.

O valor para o parâmetro SecureStoreTargetApplicationId é qualquer uma das seguintes opções:

--Credentials --WindowsCredentials --DigestCredentials --ClientCertificate

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-ServiceAddressURL

Especifica o URL para o serviço OData. O URL não precisa ser para Internet. Este é o destino final no qual os dados são recuperados.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-ServiceContext

Especifica o contexto de serviço que está no formato de uma instância de um objeto SPServiceContext, um identificador de objeto SPSiteAdministration ou um objeto SPSite. Um exemplo de um valor de contexto de serviço é um identificador do campo ID, um identificado de cadeia de caracteres, um URI ou uma representação de cadeia de caracteres de um GUID.

Type:SPServiceContextPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013, SharePoint Server 2016