Remove-DfsrPropagationTestFile
Remove-DfsrPropagationTestFile
Removes DFS Replication propagation test files.
Syntax
Parameter Set: Default
Remove-DfsrPropagationTestFile [-GroupName] <String[]> [-FolderName] <String[]> [[-ComputerName] <String> ] [-AgeInDays] <UInt32> [[-DomainName] <String> ] [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detaillierte Beschreibung
The Remove-DfsrPropagationTestFile cmdlet removes test files from a Distributed File System (DFS) Replication replicated folder. Once you remove the file from one member computer in a replication group, DFS Replication removes the file from all other members. To create test files, use the Start-DfsrPropagationTest cmdlet.
Test files contain only test metadata. You can remove them at any time.
Parameter
-AgeInDays<UInt32>
Specifies the age, in days, of propagation test files to delete. To delete propagation files created within the past 24 hours or to delete all propagation test files, set this value to zero (0).
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
4 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
false |
Platzhalterzeichen akzeptieren? |
false |
-ComputerName<String>
Specifies the name of a replication member computer. If you do not specify this parameter, the cmdlet uses the current computer.
Aliasse |
Member,Mem |
Erforderlich? |
false |
Position? |
3 |
Standardwert |
[local computer] |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-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 removes test files from all replicated folders.
Aliasse |
RF,RfName |
Erforderlich? |
true |
Position? |
2 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
true |
-Force
Erzwingt, dass der Befehl ohne Benutzerbestätigung ausgeführt wird.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
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 (*). If you do not specify this parameter, the cmdlet removes test files from replicated folders for all groups within the specified domain.
Aliasse |
RG,RgName |
Erforderlich? |
true |
Position? |
1 |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByValue, 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, Microsoft.DistributedFileSystemReplication.DfsReplicatedFolder, string
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- [none]
Beispiele
Example 1: Remove all test files from a specified replicated folder
This command removes all propagation test files from the RF07 folder on the computer named SRV01. This computer is part of the group named RG01. The value of zero (0) for the AgeInDays parameter causes the command to remove all test files, no matter how long ago you created them. The command does not include the Force parameter, so you must confirm the removal.
PS C:\> Remove-DfsrPropagationTestFile -GroupName "RG01" -FolderName "RF07" -ComputerName "SRV01" -AgeInDays 0