PowerShell Logo Small

Backup-GPO



This is the built-in help made by Microsoft for the command 'Backup-GPO', in PowerShell version 3 - as retrieved from Windows version 'Microsoft Windows Server 2012 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Backs up one GPO or all the GPOs in a domain.

SYNTAX


Backup-GPO [-Comment <String>] [-Domain <String>] [-Server <String>] -Guid <Guid> -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]
Backup-GPO [-All [<SwitchParameter>]] [-Comment <String>] [-Domain <String>] [-Server <String>] -Path <String> [-Confirm [<SwitchParameter>]]
[-WhatIf [<SwitchParameter>]] [<CommonParameters>]
Backup-GPO [-Name] <String> [-Comment <String>] [-Domain <String>] [-Server <String>] -Path <String> [-Confirm [<SwitchParameter>]] [-WhatIf
[<SwitchParameter>]] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Backup-GPO cmdlet backs up a specified GPO or all the GPOs in a domain to a backup directory. The backup directory and GPO must already
exist.



<

RELATED LINKS

Import-GPO
Restore-GPO

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

C:\PS>Backup-Gpo -Name TestGPO -Path C:\GpoBackups -Comment "Weekly Backup"

DisplayName : TestGPO

GpoId : 35c12ab3-956c-45d5-973b-46b17d225f47

Id : 2b509d4e-40f5-4337-82f7-458584555d0c

BackupDirectory : C:\GpoBackups

CreationTime : 2/25/2009 8:48:19 PM

DomainName : contoso.com

Comment : Weekly Backup



Description

-----------

This command backs up the "TestGPO" GPO to the C:\GpoBackups directory. The specified comment is included in the GPO backup.




-------------------------- EXAMPLE 2 --------------------------

C:\PS>Backup-Gpo -GUID fa4a9473-6e2a-4b87-ab78-175e68d97bde -Domain contoso.com -Server DC1 -Path \\Server1\GpoBackups



Description

-----------

This command backs up the GPO with the specified GUID in the contoso.com domain to the \\Server1\GpoBackups directory. The domain controller
at DC1.contoso.com is contacted to complete the operation.

If the domain of the user running the session (or, for startup and shutdown scripts, the computer) is different from the contoso.com domain, a
trust must exist between the two domains or the command fails.




-------------------------- EXAMPLE 3 --------------------------

C:\PS>Backup-Gpo -All -Path \\Server1\GpoBackups



Description

-----------

This command backs up all the GPOs in the domain of the user that is running the session (or, for startup and shutdown scripts, the computer)
to the \\Server1\GpoBackups directory.