Export (0) Print
Expand All

New-SPMetadataServiceApplicationProxy

 

Applies to: SharePoint Server 2010

Topic Last Modified: 2010-04-12

Creates a new connection to a managed metadata service application.

New-SPMetadataServiceApplicationProxy -Name <String> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-ContentTypePushdownEnabled <SwitchParameter>] [-ContentTypeSyndicationEnabled <SwitchParameter>] [-DefaultKeywordTaxonomy <SwitchParameter>] [-DefaultProxyGroup <SwitchParameter>] [-DefaultSiteCollectionTaxonomy <SwitchParameter>] [-PartitionMode <SwitchParameter>] [-ServiceApplication <SPMetadataServiceCmdletPipeBind>] [-Uri <String>] [-WhatIf [<SwitchParameter>]]

Use the New-SPMetadataServiceApplicationProxy cmdlet to create a new connection to a managed metadata service application.

 

Parameter Required Type Description

Name

Required

System.String

Specifies the display name of the service application proxy to create. The name can contain a maximum of 128 characters.

AssignmentCollection

Optional

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

noteNote
When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Confirm

Optional

System.Management.Automation.SwitchParameter

Prompts you for confirmation before executing the command. For more information, type the following command: get-help about_commonparameters

ContentTypePushdownEnabled

Optional

System.Management.Automation.SwitchParameter

Specifies that existing instances of changed content types in subsites and libraries will be updated.

ContentTypeSyndicationEnabled

Optional

System.Management.Automation.SwitchParameter

Specifies that this connection will provide access to the content types that are associated with the managed metadata service application.

DefaultProxyGroup

Optional

System.Management.Automation.SwitchParameter

Specifies that the connection be added to the default proxy group for the farm.

DefaultKeywordTaxonomy

Optional

System.Management.Automation.SwitchParameter

Specifies that new enterprise keywords will be stored in the term store associated with the managed metadata service application.

DefaultSiteCollectionTaxonomy

Optional

System.Management.Automation.SwitchParameter

Specifies that the term set that is created when you create a new managed metadata column will be stored in the term store associated with the managed metadata application.

PartitionMode

Optional

System.Management.Automation.SwitchParameter

Specifies that the service application restrict data by subscription.

noteNote
This property cannot be changed after the service application proxy has been created.

ServiceApplication

Optional

Microsoft.SharePoint.Taxonomy.Cmdlet.SPMetadataServiceCmdletPipeBind

Specifies the local managed metadata service application to connect to. The service application must exist on the local farm.

The type must be a valid GUID; a valid name of the service application; or an instance of a valid SPMetadataServiceApplication object.

Uri

Optional

System.String

Specifies the URI of a remote managed metadata service application to connect to.

noteNote
To specify the managed metadata service application that this proxy is connecting to, you must set only the URI parameter or only the ServiceApplication parameter.

The type must be a valid URL, in the form urn:schemas-microsoft-com:sharepoint:service:fa5c65ebed244a15817768825004f3a7#authority=urn:uuid:acdd6deff6sd4bb899f5beb42051bf3b7&authority=https:// <server>:32844/Topology/topology.svc.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

-------------------EXAMPLE 1----------------

New-SPMetadataServiceApplicationProxy -Name "MetadataServiceProxy1" -ServiceApplication "MetadataServiceApp1"

This example creates a connection to a managed metadata service application in the local farm.

-------------------EXAMPLE 2----------------

New-SPMetadataServiceApplicationProxy -Name "MetadataServiceProxy3" -ServiceApplication "MetadataServiceApp3" -PartitionMode

This example creates a partitioned connection to a managed metadata service application in the local farm.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft