﻿<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<helpItems schema="maml">
	<_locDefinition>
		<_locDefault _loc="locNone" />
		<_locTag _loc="locData">maml:para</_locTag>
		<_locTag _loc="locData">maml:title</_locTag>
	</_locDefinition>
	<command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10">
		<command:details>
			<command:name>MailboxDatabaseReseedUsingSpares.ps1</command:name>
			<maml:description>
				<maml:para _locID="CommandShortDescription">Reseeds a failed and suspended database copy after performing a series of safety checks for the environment.</maml:para>
			</maml:description>
			<maml:copyright>
				<maml:para _locID="Copyright">Copyright (c) Microsoft.  All rights reserved.</maml:para>
			</maml:copyright>
			<command:verb></command:verb>
			<command:noun></command:noun>
			<dev:version></dev:version>
		</command:details>
		<maml:description>
			<maml:para _locID="CommandLongDescription">This script is used to validate the safety of the environment, before proceeding to swap the failed database copy to a spare disk and reseed.</maml:para>
			<maml:para></maml:para>
			<maml:para>By default, the script will run its checks and report the result, but not perform the reseed.  The script can then be run a second time with the -ReseedConfirm switch to reseed the copy.  The script keeps records of when it has reseeded each copy and will not reseed again if the copy has been reseeded too often in the last two days.</maml:para>
			<maml:para></maml:para>
		</maml:description>
		<command:syntax>
			<command:syntaxItem>
				<command:name>MailboxDatabaseReseedUsingSpares.ps1</command:name>
				<command:parameter required="False" position="named">
					<maml:name>MailboxServerName</maml:name>
					<command:parameterValue required="true">String</command:parameterValue>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>MailboxDatabaseName</maml:name>
					<command:parameterValue required="true">String</command:parameterValue>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>NotifyEmail</maml:name>
					<command:parameterValue required="true">String</command:parameterValue>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>SingleActiveCopyOK</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>ReseedConfirm</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>CatalogOnly</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>SpareDiskToUse</maml:name>
					<command:parameterValue required="true">Int32</command:parameterValue>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>SkipSpareCheck</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>Help</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>WhatIf</maml:name>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>SpareDriveOverride</maml:name>
					<command:parameterValue required="true">Int32</command:parameterValue>
				</command:parameter>				
				<command:parameter required="False" position="named">
					<maml:name>WaitBeforeReseed</maml:name>
					<command:parameterValue required="true">Int32</command:parameterValue>
				</command:parameter>
				<command:parameter required="False" position="named">
					<maml:name>ReseedCount</maml:name>
					<command:parameterValue required="true">Int32</command:parameterValue>
				</command:parameter>
			</command:syntaxItem>  
		</command:syntax>
		<command:parameters>
			<command:parameter required="False" position="0">
				<maml:name>MailboxServerName</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_MailboxServerName">Name of the server that hosts the copy.  Wildcards are not permitted.</maml:para>
				</maml:description>
				<command:parameterValue required="true">String</command:parameterValue>
				<dev:type>
					<maml:name>string</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="1">
				<maml:name>MailboxDatabaseName</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_MailboxDatabaseName">Name of the database. Wildcards are not permitted.</maml:para>
				</maml:description>
				<command:parameterValue required="true">String</command:parameterValue>
				<dev:type>
					<maml:name>string</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="2">
				<maml:name>NotifyEmail</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_NotifyEmail">Address to send email notification of a reseeded database copy.</maml:para>
				</maml:description>
				<command:parameterValue required="true">String</command:parameterValue>
				<dev:type>
					<maml:name>string</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="named">
				<maml:name>SingleActiveCopyOK</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_SingleActiveCopyOK">Reseed the copy even if the only healthy copy of the database is the mounted copy.</maml:para>
				</maml:description>
				<command:parameterValue required="true">SwitchParameter</command:parameterValue>
				<dev:type>
					<maml:name>switch</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="named">
				<maml:name>ReseedConfirm</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_ReseedConfirm">When set to true, the script just reports on whether it would reseed the copy.  To proceed with the reseed, set this to false.</maml:para>
				</maml:description>
				<command:parameterValue required="true">SwitchParameter</command:parameterValue>
				<dev:type>
					<maml:name>switch</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue>True</dev:defaultValue>
			</command:parameter>
			<command:parameter required="False" position="named">
				<maml:name>CatalogOnly</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_CatalogOnly">When set, only the search catalogs, and not the database, will be reseeded.</maml:para>
				</maml:description>
				<command:parameterValue required="true">SwitchParameter</command:parameterValue>
				<dev:type>
					<maml:name>switch</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="3">
				<maml:name>SpareDiskToUse</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_SpareDiskToUse"></maml:para>
				</maml:description>
				<command:parameterValue required="true">Int32</command:parameterValue>
				<dev:type>
					<maml:name>int</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="named">
				<maml:name>SkipSpareCheck</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_SkipSpareCheck"></maml:para>
				</maml:description>
				<command:parameterValue required="true">SwitchParameter</command:parameterValue>
				<dev:type>
					<maml:name>switch</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue />
			</command:parameter>
			<command:parameter required="False" position="7">
				<maml:name>ReseedCount</maml:name>
				<maml:description>
					<maml:para _locID="Param_Description_ReseedCount">Sets the maximum number of reseeds in the last 2 days that the script will allow.</maml:para>
				</maml:description>
				<command:parameterValue required="true">Int32</command:parameterValue>
				<dev:type>
					<maml:name>int</maml:name>
					<maml:uri />
				</dev:type>
				<dev:defaultValue>5</dev:defaultValue>
			</command:parameter>
		</command:parameters>
	</command:command>
</helpItems>
