New-SPODataConnectionSetting

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

Cria uma nova conexão de serviço Conectividade de Dados Corporativos.

Syntax

New-SPODataConnectionSetting
   -AuthenticationMode <ODataAuthenticationMode>
   -ServiceAddressURL <Uri>
   -ServiceContext <SPServiceContextPipeBind>
   -Name <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ExtensionProvider <String>]
   [-SecureStoreTargetApplicationId <String>]
   [<CommonParameters>]

Description

Use o cmdlet New-SPODataConnectionSetting para criar uma nova conexão de serviço Conectividade de Dados Corporativos e suas propriedades de metadados associadas no farm. Para ver as configurações de metadados, use o cmdlet Get-SPODataConnectionSettingMetaData.

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

New-SPODataConnectionSetting -Name "ContosoServiceApp" -ServiceContext "http://contoso" -ServiceAddressURL "https://expensereporting.cloudapp.net/expensereporting.svc" -AuthenticationMode "Credentials" -SecureStoreTargetApplicationId "DallasUserName"

Este exemplo cria uma nova conexão de serviço Conectividade de Dados Corporativos denominado ContosoServiceApp.

Neste processo, é criado um objeto de metadados de conexão dos Serviços Corporativos de Conectividade da Microsoft.

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 do modo de autenticação exigido para a conexão Serviços Corporativos de Conectividade.

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

Type:ODataAuthenticationMode
Position:Named
Default value:None
Required:True
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

-Name

Especifica o nome do objeto de conexão 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 do serviço OData. O URL não precisa ser na Internet. Este é o destino final no qual os dados são recuperados.

Type:Uri
Position:Named
Default value:None
Required:True
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