< Back
Get-ADDCCloningExcludedApplicationList
Post
NAME Get-ADDCCloningExcludedApplicationList
SYNOPSIS
Returns the list of installed programs and services present on this domain controller that are not in the default
or user defined inclusion list.
SYNTAX
Get-ADDCCloningExcludedApplicationList [-Force] [-Path <String>] -GenerateXml [<CommonParameters>]
DESCRIPTION
The Get-ADDCCloningExcludedApplicationList cmdlet searches the local domain controller for programs and services
in the installed programs database, the services control manager that are not specified in the default and user
defined inclusion list. The applications in the resulting list can be added to the user defined exclusion list if
they are determined to support cloning. If the applications are not cloneable, they should be removed from the
source domain controller before the clone media is created. Any application that appears in cmdlet output and is
not included in the user defined inclusion list will force cloning to fail.
Once you have granted a source virtualized DC permissions to be cloned, the Get-ADDCCloningExcludedApplicationList
cmdlet should be run a first time with no additional parameters on the source virtualized domain controller to
identify all programs or services that are to be evaluated for cloning. Next, vet the returned list with your
software vendors and remove any applications from the list that cannot be safely cloned. Finally, you can run the
Get-ADDCCloningExcludedApplicationList cmdlet again using the ????????GenerateXml parameter set to create the
CustomDCCloneAllowList.xml file.
The Get-ADDCCloningExcludedApplicationList cmdlet needs to be run before the New-ADDCCloneConfigFile cmdlet is
used because if the New-ADDCCloneConfigFile cmdlet detects an excluded application, it will not create a
DCCloneConfig.xml file. For more information on virtual domain controller cloning, see the guidance on ADDS
virtualization at http://go.microsoft.com/fwlink/?LinkId=208030.
PARAMETERS
-Force [<SwitchParameter>]
Forces an overwrite of an existing CustomDCCloneAllowList.xml file if one is found to exist at the folder path
specified in the -Path parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GenerateXml [<SwitchParameter>]
Creates the CustomDCCloneAllowList.xml file and writes it in the location specified using the -Path parameter.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Path <String>
The folder path to use when creating the CustomDCCloneAllowList.xml file using the -GenerateXml switch
parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
ADEntity
-------------------------- EXAMPLE 1 --------------------------
C:\\PS>Get-ADDCCloningExcludedApplicationList
Description
-----------
Displays the excluded application list to the console. If there is already a CustomDCCloneAllowList.xml, this
cmdlet displays the delta of that list compared to the operating system (which may be nothing if the lists match).
-------------------------- EXAMPLE 2 --------------------------
C:\\PS>Get-ADDCCloningExcludedApplicationList -GenerateXml -Path C:\\Windows\\NTDS -Force
Description
-----------
Generates the excluded application list as a file named CustomDCCloneAllowList.xml at the specified folder path
(C:\\Windows\\NTDS) and forces overwrite if a file by that name is found to already exist at that path location.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?linkid=291023
SYNOPSIS
Returns the list of installed programs and services present on this domain controller that are not in the default
or user defined inclusion list.
SYNTAX
Get-ADDCCloningExcludedApplicationList [-Force] [-Path <String>] -GenerateXml [<CommonParameters>]
DESCRIPTION
The Get-ADDCCloningExcludedApplicationList cmdlet searches the local domain controller for programs and services
in the installed programs database, the services control manager that are not specified in the default and user
defined inclusion list. The applications in the resulting list can be added to the user defined exclusion list if
they are determined to support cloning. If the applications are not cloneable, they should be removed from the
source domain controller before the clone media is created. Any application that appears in cmdlet output and is
not included in the user defined inclusion list will force cloning to fail.
Once you have granted a source virtualized DC permissions to be cloned, the Get-ADDCCloningExcludedApplicationList
cmdlet should be run a first time with no additional parameters on the source virtualized domain controller to
identify all programs or services that are to be evaluated for cloning. Next, vet the returned list with your
software vendors and remove any applications from the list that cannot be safely cloned. Finally, you can run the
Get-ADDCCloningExcludedApplicationList cmdlet again using the ????????GenerateXml parameter set to create the
CustomDCCloneAllowList.xml file.
The Get-ADDCCloningExcludedApplicationList cmdlet needs to be run before the New-ADDCCloneConfigFile cmdlet is
used because if the New-ADDCCloneConfigFile cmdlet detects an excluded application, it will not create a
DCCloneConfig.xml file. For more information on virtual domain controller cloning, see the guidance on ADDS
virtualization at http://go.microsoft.com/fwlink/?LinkId=208030.
PARAMETERS
-Force [<SwitchParameter>]
Forces an overwrite of an existing CustomDCCloneAllowList.xml file if one is found to exist at the folder path
specified in the -Path parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-GenerateXml [<SwitchParameter>]
Creates the CustomDCCloneAllowList.xml file and writes it in the location specified using the -Path parameter.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Path <String>
The folder path to use when creating the CustomDCCloneAllowList.xml file using the -GenerateXml switch
parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
None
OUTPUTS
ADEntity
-------------------------- EXAMPLE 1 --------------------------
C:\\PS>Get-ADDCCloningExcludedApplicationList
Description
-----------
Displays the excluded application list to the console. If there is already a CustomDCCloneAllowList.xml, this
cmdlet displays the delta of that list compared to the operating system (which may be nothing if the lists match).
-------------------------- EXAMPLE 2 --------------------------
C:\\PS>Get-ADDCCloningExcludedApplicationList -GenerateXml -Path C:\\Windows\\NTDS -Force
Description
-----------
Generates the excluded application list as a file named CustomDCCloneAllowList.xml at the specified folder path
(C:\\Windows\\NTDS) and forces overwrite if a file by that name is found to already exist at that path location.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/p/?linkid=291023