Link

Export-TfsGlobalList

Exports the contents of one or more Global Lists to XML.


Table of Contents

  1. Syntax
  2. Description
  3. Examples
  4. Parameters
  5. Inputs
  6. Outputs
  7. Related Links

Syntax

Export-TfsGlobalList
    [-GlobalList <object>]
    [-Collection <object>]

[Go to top]

Description

This cmdlets generates an XML containing one or more global lists and their respective items, in the same format used by witadmin. It is functionally equivalent to “witadmin exportgloballist”

[Go to top]

Examples

Example 1

Exports all global lists in the current project collection to a file called gl.xml.

PS> Export-TfsGlobalList | Out-File "gl.xml"

Example 2

Exports all build-related global lists (with names starting with “Build - “) and return the resulting XML document.

PS> Export-TfsGlobalList -Name "Builds - *"

Parameters

-Collection

Specifies the URL to the Team Project Collection or Azure DevOps Organization to connect to, a TfsTeamProjectCollection object (Windows PowerShell only), or a VssConnection object. You can also connect to an Azure DevOps Services organizations by simply providing its name instead of the full URL. For more details, see the Get-TfsTeamProjectCollection cmdlet. When omitted, it defaults to the connection set by Connect-TfsTeamProjectCollection (if any).

Type object
Position (Named)
Default Value (N/A)
Accept pipeline input True (byvalue)
Accept wildcard characters False

-GlobalList (Aliases: Name)

Specifies the name of the global list to be exported. Wildcards are supported. When omitted, it defaults to all global lists in the supplied team project collection. When using wilcards, a single XML document will be producer containing all matching global lists.

Type object
Position 0
Default Value *
Accept pipeline input False
Accept wildcard characters False

Inputs

System.Object

Specifies the URL to the Team Project Collection or Azure DevOps Organization to connect to, a TfsTeamProjectCollection object (Windows PowerShell only), or a VssConnection object. You can also connect to an Azure DevOps Services organizations by simply providing its name instead of the full URL. For more details, see the Get-TfsTeamProjectCollection cmdlet. When omitted, it defaults to the connection set by Connect-TfsTeamProjectCollection (if any).

Outputs

System.String