Set-SPODataConnectionSetting
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 |