Partilhar via

Remove-SPODataConnectionSetting

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

Remove uma conexão dos Serviços Corporativos de Conectividade.

Syntax

Remove-SPODataConnectionSetting
      [-Identity] <ODataConnectionSettings>
      -ServiceContext <SPServiceContextPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]
Remove-SPODataConnectionSetting
      -ServiceContext <SPServiceContextPipeBind>
      -Name <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-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 Remove-SPODataConnectionSetting para remover uma conexão dos Serviços Corporativos de Conectividade para um determinado aplicativo de serviço dos Serviços Corporativos de Conectividade no farm.

O objeto de metadados associado à conexão dos Serviços Corporativos de Conectividade também é excluído.

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 recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

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

Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp"

Este exemplo remove a conexão dos Serviços Corporativos de Conectividade denominada ContosoServiceApp. As propriedades de metadados também são removidas.

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

Remove-SPODataConnectionSetting -ServiceContext "http://contoso" -Name "ContosoServiceApp-metadata"

Este exemplo remove os metadados de conexão dos Serviços Corporativos de Conectividade denominados ContosoServiceApp.

O objeto de conexão dos Serviços Corporativos de Conectividade também é removido.

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

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

Remove-SPODataConnectionSetting -Identity $ConnectionVariable -ServiceContext "http://contoso"

Este exemplo remove os Serviços Corporativos de Conectividade e sua conexão de metadados associada denominada ContosoServiceApp.

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

-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

-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

-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