Skip to content

Commit fb3d7cd

Browse files
niphlodgithub-actions[bot]
authored andcommitted
refreshing docs pages
1 parent 5be9013 commit fb3d7cd

File tree

692 files changed

+6346
-6247
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

692 files changed

+6346
-6247
lines changed

Add-DbaAgDatabase.html

+23-20
Original file line numberDiff line numberDiff line change
@@ -517,13 +517,15 @@ <h2 id="description">Description</h2>
517517
<li>Step 5: Wait for the database to finish joining the Availability Group on the secondary replicas.</li>
518518
</ul>
519519
<p>Use Test-DbaAvailabilityGroup with -AddDatabase to test if all prerequisites are met.</p>
520-
<p>If you have special requirements for the setup for the database at the replicas,
521-
perform the backup and restore part with Backup-DbaDatabase and Restore-DbaDatabase in advance.
520+
<p>If you have special requirements for the setup for the database at the replicas,<br />
521+
perform the backup and restore part with Backup-DbaDatabase and Restore-DbaDatabase in advance.<br />
522522
Please make sure that the last log backup has been restored before running Add-DbaAgDatabase.</p>
523523
<h2 id="syntax">Syntax</h2>
524524
<pre><code>Add-DbaAgDatabase
525525
[-SqlInstance] &lt;DbaInstanceParameter&gt;
526-
[-SqlCredential &lt;PSCredential&gt;] -AvailabilityGroup &lt;String&gt; -Database &lt;String[]&gt;
526+
[-SqlCredential &lt;PSCredential&gt;]
527+
-AvailabilityGroup &lt;String&gt;
528+
-Database &lt;String[]&gt;
527529
[-Secondary &lt;DbaInstanceParameter[]&gt;]
528530
[-SecondarySqlCredential &lt;PSCredential&gt;]
529531
[-SeedingMode &lt;String&gt;]
@@ -538,7 +540,8 @@ <h2 id="syntax">Syntax</h2>
538540
Add-DbaAgDatabase
539541
[-AvailabilityGroup] &lt;String&gt;
540542
[-Secondary &lt;DbaInstanceParameter[]&gt;]
541-
[-SecondarySqlCredential &lt;PSCredential&gt;] -InputObject &lt;Database[]&gt;
543+
[-SecondarySqlCredential &lt;PSCredential&gt;]
544+
-InputObject &lt;Database[]&gt;
542545
[-SeedingMode &lt;String&gt;]
543546
[-SharedPath &lt;String&gt;]
544547
[-UseLastBackup]
@@ -586,7 +589,7 @@ <h5 id="example-5">Example: 5</h5>
586589
<p>Adds db1 to ag1 on sql2017a and sql2017b. Uses compression and three files while taking the backups.<br></p>
587590
<h3 id="required-parameters">Required Parameters</h3>
588591
<h5 id="sqlinstance">-SqlInstance</h5>
589-
<p>The primary replica of the Availability Group. Server version must be SQL Server version 2012 or higher.<br></p>
592+
<p>The primary replica of the Availability Group. Server version must be SQL Server version 2012 or higher. <br></p>
590593
<table>
591594
<thead>
592595
<tr>
@@ -614,7 +617,7 @@ <h5 id="sqlinstance">-SqlInstance</h5>
614617
</tbody>
615618
</table>
616619
<h5 id="availabilitygroup">-AvailabilityGroup</h5>
617-
<p>The name of the Availability Group where the databases will be added.<br></p>
620+
<p>The name of the Availability Group where the databases will be added. <br></p>
618621
<table>
619622
<thead>
620623
<tr>
@@ -642,7 +645,7 @@ <h5 id="availabilitygroup">-AvailabilityGroup</h5>
642645
</tbody>
643646
</table>
644647
<h5 id="database">-Database</h5>
645-
<p>The database(s) to add.<br></p>
648+
<p>The database(s) to add. <br></p>
646649
<table>
647650
<thead>
648651
<tr>
@@ -670,7 +673,7 @@ <h5 id="database">-Database</h5>
670673
</tbody>
671674
</table>
672675
<h5 id="inputobject">-InputObject</h5>
673-
<p>Enables piping from Get-DbaDatabase, Get-DbaDbSharePoint and more.<br></p>
676+
<p>Enables piping from Get-DbaDatabase, Get-DbaDbSharePoint and more. <br></p>
674677
<table>
675678
<thead>
676679
<tr>
@@ -699,8 +702,8 @@ <h5 id="inputobject">-InputObject</h5>
699702
</table>
700703
<h3 id="optional-parameters">Optional Parameters</h3>
701704
<h5 id="sqlcredential">-SqlCredential</h5>
702-
<p>Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
703-
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.
705+
<p>Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).<br />
706+
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.<br />
704707
For MFA support, please use Connect-DbaInstance.<br></p>
705708
<table>
706709
<thead>
@@ -729,7 +732,7 @@ <h5 id="sqlcredential">-SqlCredential</h5>
729732
</tbody>
730733
</table>
731734
<h5 id="secondary">-Secondary</h5>
732-
<p>Not required - the command will figure this out. But use this parameter if secondary replicas listen on a non default port.
735+
<p>Not required - the command will figure this out. But use this parameter if secondary replicas listen on a non default port.<br />
733736
This parameter can be used to only add the databases on specific secondary replicas.<br></p>
734737
<table>
735738
<thead>
@@ -758,8 +761,8 @@ <h5 id="secondary">-Secondary</h5>
758761
</tbody>
759762
</table>
760763
<h5 id="secondarysqlcredential">-SecondarySqlCredential</h5>
761-
<p>Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).
762-
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.
764+
<p>Login to the target instance using alternative credentials. Accepts PowerShell credentials (Get-Credential).<br />
765+
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.<br />
763766
For MFA support, please use Connect-DbaInstance.<br></p>
764767
<table>
765768
<thead>
@@ -788,9 +791,9 @@ <h5 id="secondarysqlcredential">-SecondarySqlCredential</h5>
788791
</tbody>
789792
</table>
790793
<h5 id="seedingmode">-SeedingMode</h5>
791-
<p>Specifies how the secondary replica will be initially seeded.
792-
Automatic enables direct seeding. This method will seed the secondary replica over the network. This method does not require you to backup and restore a copy of the primary database on the replica.
793-
Manual uses full and log backup to initially transfer the data to the secondary replica. The command skips this if the database is found in restoring state at the secondary replica.
794+
<p>Specifies how the secondary replica will be initially seeded.<br />
795+
Automatic enables direct seeding. This method will seed the secondary replica over the network. This method does not require you to backup and restore a copy of the primary database on the replica.<br />
796+
Manual uses full and log backup to initially transfer the data to the secondary replica. The command skips this if the database is found in restoring state at the secondary replica.<br />
794797
If not specified, the setting from the availability group replica will be used. Otherwise the setting will be updated.<br></p>
795798
<table>
796799
<thead>
@@ -823,8 +826,8 @@ <h5 id="seedingmode">-SeedingMode</h5>
823826
</tbody>
824827
</table>
825828
<h5 id="sharedpath">-SharedPath</h5>
826-
<p>The network share where the backups will be backed up and restored from.
827-
Each SQL Server service account must have access to this share.
829+
<p>The network share where the backups will be backed up and restored from.<br />
830+
Each SQL Server service account must have access to this share.<br />
828831
NOTE: If a backup / restore is performed, the backups will be left in tact on the network share.<br></p>
829832
<table>
830833
<thead>
@@ -909,8 +912,8 @@ <h5 id="advancedbackupparams">-AdvancedBackupParams</h5>
909912
</tbody>
910913
</table>
911914
<h5 id="enableexception">-EnableException</h5>
912-
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
913-
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.
915+
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.<br />
916+
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.<br />
914917
Using this switch turns this &quot;nice by default&quot; feature off and enables you to catch exceptions with your own try/catch.<br></p>
915918
<table>
916919
<thead>

Add-DbaAgListener.html

+3-3
Original file line numberDiff line numberDiff line change
@@ -608,7 +608,7 @@ <h5 id="availabilitygroup">-AvailabilityGroup</h5>
608608
</tbody>
609609
</table>
610610
<h5 id="name">-Name</h5>
611-
<p>The name of the listener. If one is not specified, the Availability Group name will be used.
611+
<p>The name of the listener. If one is not specified, the Availability Group name will be used.<br />
612612
Note that Name cannot be used with Multiple Ags.<br></p>
613613
<table>
614614
<thead>
@@ -833,8 +833,8 @@ <h5 id="inputobject">-InputObject</h5>
833833
</tbody>
834834
</table>
835835
<h5 id="enableexception">-EnableException</h5>
836-
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
837-
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.
836+
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.<br />
837+
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.<br />
838838
Using this switch turns this &quot;nice by default&quot; feature off and enables you to catch exceptions with your own try/catch.<br></p>
839839
<table>
840840
<thead>

Add-DbaAgReplica.html

+26-26
Original file line numberDiff line numberDiff line change
@@ -533,7 +533,7 @@ <h5 id="example-3">Example: 3</h5>
533533
<p>Adds sql2017b to the SharePoint availability group on sql2017a with a custom endpoint URL.<br></p>
534534
<h3 id="required-parameters">Required Parameters</h3>
535535
<h5 id="sqlinstance">-SqlInstance</h5>
536-
<p>The target SQL Server instance or instances. Server version must be SQL Server version 2012 or higher.<br></p>
536+
<p>The target SQL Server instance or instances. Server version must be SQL Server version 2012 or higher. <br></p>
537537
<table>
538538
<thead>
539539
<tr>
@@ -561,7 +561,7 @@ <h5 id="sqlinstance">-SqlInstance</h5>
561561
</tbody>
562562
</table>
563563
<h5 id="inputobject">-InputObject</h5>
564-
<p>Enables piping from Get-DbaAvailabilityGroup.<br></p>
564+
<p>Enables piping from Get-DbaAvailabilityGroup. <br></p>
565565
<table>
566566
<thead>
567567
<tr>
@@ -590,8 +590,8 @@ <h5 id="inputobject">-InputObject</h5>
590590
</table>
591591
<h3 id="optional-parameters">Optional Parameters</h3>
592592
<h5 id="sqlcredential">-SqlCredential</h5>
593-
<p>Login to the target instances using alternative credentials. Accepts PowerShell credentials (Get-Credential).
594-
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.
593+
<p>Login to the target instances using alternative credentials. Accepts PowerShell credentials (Get-Credential).<br />
594+
Windows Authentication, SQL Server Authentication, Active Directory - Password, and Active Directory - Integrated are all supported.<br />
595595
For MFA support, please use Connect-DbaInstance.<br></p>
596596
<table>
597597
<thead>
@@ -620,7 +620,7 @@ <h5 id="sqlcredential">-SqlCredential</h5>
620620
</tbody>
621621
</table>
622622
<h5 id="name">-Name</h5>
623-
<p>The name of the replica. Defaults to the SQL Server instance name.
623+
<p>The name of the replica. Defaults to the SQL Server instance name.<br />
624624
This parameter is only supported if the replica is added to just one instance.<br></p>
625625
<table>
626626
<thead>
@@ -649,10 +649,10 @@ <h5 id="name">-Name</h5>
649649
</tbody>
650650
</table>
651651
<h5 id="clustertype">-ClusterType</h5>
652-
<p>Cluster type of the Availability Group. Only supported in SQL Server 2017 and above.
653-
Options include: Wsfc, External or None.
654-
Defaults to Wsfc (Windows Server Failover Cluster).
655-
The default can be changed with:
652+
<p>Cluster type of the Availability Group. Only supported in SQL Server 2017 and above.<br />
653+
Options include: Wsfc, External or None.<br />
654+
Defaults to Wsfc (Windows Server Failover Cluster).<br />
655+
The default can be changed with:<br />
656656
Set-DbatoolsConfig -FullName 'AvailabilityGroups.Default.ClusterType' -Value '...' -Passthru | Register-DbatoolsConfig<br></p>
657657
<table>
658658
<thead>
@@ -809,10 +809,10 @@ <h5 id="connectionmodeinprimaryrole">-ConnectionModeInPrimaryRole</h5>
809809
</tbody>
810810
</table>
811811
<h5 id="connectionmodeinsecondaryrole">-ConnectionModeInSecondaryRole</h5>
812-
<p>Specifies the connection modes of an Availability Replica in secondary role.
813-
Options include: AllowNoConnections, AllowReadIntentConnectionsOnly, AllowAllConnections
814-
Defaults to AllowNoConnections.
815-
The default can be changed with:
812+
<p>Specifies the connection modes of an Availability Replica in secondary role.<br />
813+
Options include: AllowNoConnections, AllowReadIntentConnectionsOnly, AllowAllConnections<br />
814+
Defaults to AllowNoConnections.<br />
815+
The default can be changed with:<br />
816816
Set-DbatoolsConfig -FullName 'AvailabilityGroups.Default.ConnectionModeInSecondaryRole' -Value '...' -Passthru | Register-DbatoolsConfig<br></p>
817817
<table>
818818
<thead>
@@ -845,8 +845,8 @@ <h5 id="connectionmodeinsecondaryrole">-ConnectionModeInSecondaryRole</h5>
845845
</tbody>
846846
</table>
847847
<h5 id="seedingmode">-SeedingMode</h5>
848-
<p>Specifies how the secondary replica will be initially seeded.
849-
Automatic enables direct seeding. This method will seed the secondary replica over the network. This method does not require you to backup and restore a copy of the primary database on the replica.
848+
<p>Specifies how the secondary replica will be initially seeded.<br />
849+
Automatic enables direct seeding. This method will seed the secondary replica over the network. This method does not require you to backup and restore a copy of the primary database on the replica.<br />
850850
Manual requires you to create a backup of the database on the primary replica and manually restore that backup on the secondary replica.<br></p>
851851
<table>
852852
<thead>
@@ -879,7 +879,7 @@ <h5 id="seedingmode">-SeedingMode</h5>
879879
</tbody>
880880
</table>
881881
<h5 id="endpoint">-Endpoint</h5>
882-
<p>By default, this command will attempt to find a DatabaseMirror endpoint. If one does not exist, it will create it.
882+
<p>By default, this command will attempt to find a DatabaseMirror endpoint. If one does not exist, it will create it.<br />
883883
If an endpoint must be created, the name &quot;hadr_endpoint&quot; will be used. If an alternative is preferred, use Endpoint.<br></p>
884884
<table>
885885
<thead>
@@ -908,10 +908,10 @@ <h5 id="endpoint">-Endpoint</h5>
908908
</tbody>
909909
</table>
910910
<h5 id="endpointurl">-EndpointUrl</h5>
911-
<p>By default, the property Fqdn of Get-DbaEndpoint is used as EndpointUrl.
912-
Use EndpointUrl if a different URL is required due to special network configurations.
913-
EndpointUrl has to be an array of strings in format 'TCP://system-address:port', one entry for every instance.
914-
See details at: <a href="https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/specify-endpoint-url-adding-or-modifying-availability-replica">https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/specify-endpoint-url-adding-or-modifying-availability-replica</a>
911+
<p>By default, the property Fqdn of Get-DbaEndpoint is used as EndpointUrl.<br />
912+
Use EndpointUrl if a different URL is required due to special network configurations.<br />
913+
EndpointUrl has to be an array of strings in format 'TCP://system-address:port', one entry for every instance.<br />
914+
See details at: <a href="https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/specify-endpoint-url-adding-or-modifying-availability-replica">https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/specify-endpoint-url-adding-or-modifying-availability-replica</a><br />
915915
If an endpoint must be created, EndpointUrl will be used for configuration, if system-address is an ipv4 address.<br></p>
916916
<table>
917917
<thead>
@@ -968,7 +968,7 @@ <h5 id="passthru">-Passthru</h5>
968968
</tbody>
969969
</table>
970970
<h5 id="readonlyroutinglist">-ReadOnlyRoutingList</h5>
971-
<p>Sets the read only routing ordered list of replica server names to use when redirecting read-only connections through this availability replica.
971+
<p>Sets the read only routing ordered list of replica server names to use when redirecting read-only connections through this availability replica.<br />
972972
This parameter is only supported if the replica is added to just one instance.<br></p>
973973
<table>
974974
<thead>
@@ -997,7 +997,7 @@ <h5 id="readonlyroutinglist">-ReadOnlyRoutingList</h5>
997997
</tbody>
998998
</table>
999999
<h5 id="readonlyroutingconnectionurl">-ReadonlyRoutingConnectionUrl</h5>
1000-
<p>Sets the read only routing connection url for the availability replica.
1000+
<p>Sets the read only routing connection url for the availability replica.<br />
10011001
This parameter is only supported if the replica is added to just one instance.<br></p>
10021002
<table>
10031003
<thead>
@@ -1026,7 +1026,7 @@ <h5 id="readonlyroutingconnectionurl">-ReadonlyRoutingConnectionUrl</h5>
10261026
</tbody>
10271027
</table>
10281028
<h5 id="certificate">-Certificate</h5>
1029-
<p>Specifies that the endpoint is to authenticate the connection using the certificate specified by certificate_name to establish identity for authorization.
1029+
<p>Specifies that the endpoint is to authenticate the connection using the certificate specified by certificate_name to establish identity for authorization.<br />
10301030
The far endpoint must have a certificate with the public key matching the private key of the specified certificate.<br></p>
10311031
<table>
10321032
<thead>
@@ -1055,7 +1055,7 @@ <h5 id="certificate">-Certificate</h5>
10551055
</tbody>
10561056
</table>
10571057
<h5 id="configurexesession">-ConfigureXESession</h5>
1058-
<p>Configure the AlwaysOn_health extended events session to start automatically as the SSMS wizard would do.
1058+
<p>Configure the AlwaysOn_health extended events session to start automatically as the SSMS wizard would do.<br />
10591059
<a href="https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/always-on-extended-events#BKMK_alwayson_health">https://docs.microsoft.com/en-us/sql/database-engine/availability-groups/windows/always-on-extended-events#BKMK_alwayson_health</a><br></p>
10601060
<table>
10611061
<thead>
@@ -1112,8 +1112,8 @@ <h5 id="sessiontimeout">-SessionTimeout</h5>
11121112
</tbody>
11131113
</table>
11141114
<h5 id="enableexception">-EnableException</h5>
1115-
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
1116-
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.
1115+
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.<br />
1116+
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.<br />
11171117
Using this switch turns this &quot;nice by default&quot; feature off and enables you to catch exceptions with your own try/catch.<br></p>
11181118
<table>
11191119
<thead>

Add-DbaComputerCertificate.html

+14-14
Original file line numberDiff line numberDiff line change
@@ -721,18 +721,18 @@ <h5 id="folder">-Folder</h5>
721721
</tbody>
722722
</table>
723723
<h5 id="flag">-Flag</h5>
724-
<p>Defines where and how to import the private key of an X.509 certificate.
725-
Defaults to: Exportable, PersistKeySet
726-
EphemeralKeySet
727-
The key associated with a PFX file is created in memory and not persisted on disk when importing a certificate.
728-
Exportable
729-
Imported keys are marked as exportable.
730-
NonExportable
731-
Expliictly mark keys as nonexportable.
732-
PersistKeySet
733-
The key associated with a PFX file is persisted when importing a certificate.
734-
UserProtected
735-
Notify the user through a dialog box or other method that the key is accessed. The Cryptographic Service Provider (CSP) in use defines the precise behavior. NOTE: This can only be used when you
724+
<p>Defines where and how to import the private key of an X.509 certificate.<br />
725+
Defaults to: Exportable, PersistKeySet<br />
726+
EphemeralKeySet<br />
727+
The key associated with a PFX file is created in memory and not persisted on disk when importing a certificate.<br />
728+
Exportable<br />
729+
Imported keys are marked as exportable.<br />
730+
NonExportable<br />
731+
Expliictly mark keys as nonexportable.<br />
732+
PersistKeySet<br />
733+
The key associated with a PFX file is persisted when importing a certificate.<br />
734+
UserProtected<br />
735+
Notify the user through a dialog box or other method that the key is accessed. The Cryptographic Service Provider (CSP) in use defines the precise behavior. NOTE: This can only be used when you<br />
736736
add a certificate to localhost, as it causes a prompt to appear.<br></p>
737737
<table>
738738
<thead>
@@ -765,8 +765,8 @@ <h5 id="flag">-Flag</h5>
765765
</tbody>
766766
</table>
767767
<h5 id="enableexception">-EnableException</h5>
768-
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.
769-
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.
768+
<p>By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message.<br />
769+
This avoids overwhelming you with &quot;sea of red&quot; exceptions, but is inconvenient because it basically disables advanced scripting.<br />
770770
Using this switch turns this &quot;nice by default&quot; feature off and enables you to catch exceptions with your own try/catch.<br></p>
771771
<table>
772772
<thead>

0 commit comments

Comments
 (0)