Compartilhar via


Remove-DfsReplicationGroup

Remove-DfsReplicationGroup

Removes a replication group.

Sintaxe

Parameter Set: Default
Remove-DfsReplicationGroup [-GroupName] <String[]> [[-DomainName] <String> ] [-Force] [-RemoveReplicatedFolders] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descrição detalhada

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.

Parâmetros

-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.

Aliases

nenhuma

Necessário?

false

Posição?

101

Valor padrão

[Current Domain]

Aceitar entrada do pipeline?

True (ByPropertyName)

Aceitar caracteres curinga?

false

-Force

Força o comando a ser executado sem solicitar a confirmação do usuário. Use this parameter for scripted removal of replication groups.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

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.

Aliases

RG,RgName

Necessário?

true

Posição?

1

Valor padrão

nenhuma

Aceitar entrada do pipeline?

True (ByValue, ByPropertyName)

Aceitar caracteres curinga?

true

-RemoveReplicatedFolders

Indicates that the cmdlet removes any replicated folders belonging to the replication group prior to deleting the replication group.

Aliases

nenhuma

Necessário?

false

Posição?

named

Valor padrão

nenhuma

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita que você confirme antes de executar o cmdlet.

Necessário?

false

Posição?

named

Valor padrão

false

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Necessário?

false

Posição?

named

Valor padrão

false

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet dá suporte a parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet.

  • Microsoft.DistributedFileSystemReplication.DfsReplicationGroup

Saídas

O tipo de saída é o tipo de objeto emitido pelo cmdlet.

  • [none]

Exemplos

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

Tópicos relacionados

Get-DfsReplicationGroup

New-DfsReplicationGroup

Set-DfsReplicationGroup