Remove-DfsReplicationGroup
Remove-DfsReplicationGroup
Removes a replication group.
구문
Parameter Set: Default
Remove-DfsReplicationGroup [-GroupName] <String[]> [[-DomainName] <String> ] [-Force] [-RemoveReplicatedFolders] [-Confirm] [-WhatIf] [ <CommonParameters>]
자세한 설명
The Remove-DfsReplicationGroup cmdlet removes a replication group.
When you remove a replication group, you remove the group from Active Directory, and you also delete all associated aspects of the DFS Replication topology for that replication group, such as members, memberships, and connections. All replication halts on all members. This operation does not delete any replicated file data or private data. Use this command only when you decommission a replication group.
매개 변수
-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 this parameter, the cmdlet uses the current domain.
별칭 |
없음 |
필수 여부 |
false |
위치 |
101 |
기본값 |
[Current Domain] |
파이프라인 입력 적용 여부 |
True (ByPropertyName) |
와일드카드 문자 허용 여부 |
false |
-Force
사용자 확인을 요구하지 않고 명령을 실행합니다. Use this parameter for scripted removal of replication groups.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-GroupName<String[]>
Specifies an array of names of replication groups. You can specify multiple groups, separated by commas, as well as wildcard characters (*).
If the replication group contains any replicated folders, you must specify the RemoveReplicatedFolders switch parameter.
별칭 |
RG,RgName |
필수 여부 |
true |
위치 |
1 |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
True (ByValue, ByPropertyName) |
와일드카드 문자 허용 여부 |
true |
-RemoveReplicatedFolders
Indicates that the cmdlet removes any replicated folders belonging to the replication group prior to deleting the replication group.
별칭 |
없음 |
필수 여부 |
false |
위치 |
named |
기본값 |
없음 |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
필수 여부 |
false |
위치 |
named |
기본값 |
false |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
false |
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).
입력
입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.
- Microsoft.DistributedFileSystemReplication.DfsReplicationGroup
출력
출력 유형은 cmdlet이 내보내는 개체의 유형입니다.
- [none]
예제
Example 1: Remove a replication group
This command removes the replication group named RG01 from the current domain.
PS C:\> Remove-DfsReplicationGroup -GroupName "RG01"
Example 2: Remove replication groups using a wildcard
This command removes all replication groups that include the pattern RG* in domain corp.contoso.com, even if the groups include replicated folders.
PS C:\> Remove-DfsReplicationGroup -GroupName "RG*" -RemoveReplicatedFolders -Domain corp.contoso.com -RemoveReplicatedFolders