Export (0) Print
Expand All

ConvertFrom-DfsrGuid

Windows Server 2012 R2 and Windows 8.1

Updated: October 17, 2013

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

ConvertFrom-DfsrGuid

Translates GUIDs to friendly names within a given replication group.

Syntax

Parameter Set: Default
ConvertFrom-DfsrGuid [-GroupName] <String[]> [-Guid] <Guid[]> [[-DomainName] <String> ] [ <CommonParameters>]




Detailed Description

The ConvertFrom-DfsrGuid cmdlet translates DFS Replication GUIDs to friendly names within a given replication group. DFS Replication uses GUIDs to represent the friendly names of various objects and metadata. DFS Replication writes these GUIDs to Active Directory, XML files, the event log, and debug logs. This cmdlet converts GUIDs for connections (connid), replicated folders (csid), replication groups (rgid), volumes (volumeid), members (memberid), and databases (dbguid).

Parameters

-DomainName<String>

Specifies a NetBIOS or fully qualified domain name (FQDN) for an Active Directory domain that contains the replication group. If you do not specify, the cmdlet uses the current domain of the user.


Aliases

none

Required?

false

Position?

101

Default Value

[Current Domain]

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-GroupName<String[]>

Specifies an array of names of replication groups. If you do not specify this parameter, the cmdlet queries for all participating replication groups. You can specify multiple groups, separated by commas, as well as wildcard characters (*).


Aliases

RG,RgName

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

true

-Guid<Guid[]>

Specifies an array of GUID values to convert to a friendly name.


Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, Guid

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder, Microsoft.DistributedFileSystemReplication.DfsrMember, Microsoft.DistributedFileSystemReplication.DfsrMembership, Microsoft.DistributedFileSystemReplication.DfsrConnection, Microsoft.DistributedFileSystemReplication.DfsrVolume

Examples

Convert a GUID to a friendly name

This command uses the ConvertFrom-DfsrGuid cmdlet to convert a replicated folder GUID to its friendly details.


PS C:\> ConvertFrom-DfsrGuid -GroupName RG01 "9268F23A-7701-4184-8B8B-4BFDBB8AC411"
GroupName              : RG01
FolderName             : RF01
DomainName             : corp.contoso.com
Identifier             : 9268f23a-7701-4184-8b8b-4bfdbb8ac411
Description            :
FileNameToExclude      : {~*, *.bak, *.tmp}
DirectoryNameToExclude : {}
DfsnPath               :
IsDfsnPathPublished    : False

Example 2: Determine which server originated a file modification

This example looks up a Global Version Sequence Number (GUID) for a file, and then looks up the name of the server that originated that change.

The first command uses the Get-DfsrIdRecord cmdlet to lookup a file’s Global Version Sequence Number (GUID).

The second command looks up the server that originated thechange.


PS C:\> Get-DfsrIdRecord -Path C:\rf01\canary.bmp | Format-List global* GlobalVersionSequenceNumber : {B34A6F21-A20D-402D-9BE1-467309C21CDF}-v20
PS C:\> ConvertFrom-DfsrGuid -GroupName Rg01 -guid B34A6F21-A20D-402D-9BE1-467309C21CDF

ComputerName : SRV01
DomainName   : corp.contoso.com
VolumeGuid   : 9ee0fc3b-a906-11e2-8f95-806e6f6e6963
SerialNumber : 903727946
Path         : \\.\C:
DatabaseGuid : B34A6F21-A20D-402D-9BE1-467309C21CDF

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