ConvertFrom-DfsrGuid
ConvertFrom-DfsrGuid
Translates GUIDs to friendly names within a given replication group.
Syntaxe
Parameter Set: Default
ConvertFrom-DfsrGuid [-GroupName] <String[]> [-Guid] <Guid[]> [[-DomainName] <String> ] [ <CommonParameters>]
Description détaillée
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).
Paramètres
-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.
Alias |
none |
Obligatoire ? |
false |
Position ? |
101 |
Valeur par défaut |
[Current Domain] |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
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 (*).
Alias |
RG,RgName |
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
true |
-Guid<Guid[]>
Specifies an array of GUID values to convert to a friendly name.
Alias |
none |
Obligatoire ? |
true |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByPropertyName) |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, Guid
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder, Microsoft.DistributedFileSystemReplication.DfsrMember, Microsoft.DistributedFileSystemReplication.DfsrMembership, Microsoft.DistributedFileSystemReplication.DfsrConnection, Microsoft.DistributedFileSystemReplication.DfsrVolume
Exemples
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"
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