Remove-DfsReplicatedFolder
Remove-DfsReplicatedFolder
Removes a replicated folder from a replication group.
Syntax
Parameter Set: Default
Remove-DfsReplicatedFolder [-GroupName] <String[]> [-FolderName] <String[]> [[-Force]] [[-DomainName] <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detaillierte Beschreibung
The Remove-DfsReplicatedFolder cmdlet removes replicated folders from a replication group. Replicated folders are logical arrangements of replication that do not contain computer-specific settings.
When you remove a replicated folder, the DFS Replication (DSFR) service cannot replicate the folder. This operation does not delete any replicated file data. Use this cmdlet only when you decommission a replicated folder.
Parameter
-DomainName<String>
Specifies the NetBIOS name or fully qualified domain name (FQDN) for the Active Directory Domain Service (AD DS) domain that contains the replication group. If you do not specify this parameter, the cmdlet uses the domain of the current user.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
101 |
Standardwert |
[Current Domain] |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-FolderName<String[]>
Specifies an array of names of replicated folders. You can use a comma separated list and the wildcard character (*). If you do not specify this parameter, the cmdlet gets all replicated folders.
Aliasse |
RF,RfName |
Erforderlich? |
true |
Position? |
2 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByValue, ByPropertyName) |
Platzhalterzeichen akzeptieren? |
true |
-Force
Erzwingt, dass der Befehl ohne Benutzerbestätigung ausgeführt wird.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
3 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-GroupName<String[]>
Specifies an array of names of replication groups. You can use a comma separated list and the wildcard character (*).
Aliasse |
RG,RgName |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
true |
-Confirm
Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.
Erforderlich? |
false |
Position? |
named |
Standardwert |
falsch |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
Erforderlich? |
false |
Position? |
named |
Standardwert |
falsch |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup, string
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- [none]
Beispiele
Example 1: Remove a replicated folder
This command removes the replicated folder RF22 and its associated memberships from the replication group named RG11.
PS C:\> Remove-DfsReplicatedFolder -GroupName "RG11" -FolderName "RF22"
Example 2: Remove all replicated folders associated with a replication group
This command removes all replicated folders and their associated memberships from the replication group named RG11. The Force parameter specifies that the cmdlet does not prompt you to confirm that you want to remove each replicated folder.
PS C:\> Remove-DfsReplicatedFolder -GroupName "RG11" -FolderName * -Force