Get-DatabaseAvailabilityGroup

モジュール:
Exchange PowerShell

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Get-DatabaseAvailabilityGroup コマンドレットを使用して、データベース可用性グループ (DAG) に関するさまざまな構成設定、状態、その他の情報を取得します。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Default (既定) 

Get-DatabaseAvailabilityGroup
    [[-Identity] <DatabaseAvailabilityGroupIdParameter>]
    [-DomainController <Fqdn>]
    [-Status]
    [<CommonParameters>]

説明

DAG メンバーのリストの取得に加え、Get-DatabaseAvailabilityGroup コマンドレットを使用して、次のような DAG のリアルタイム状態情報を表示することもできます。

  • OperationalServers
  • PrimaryActiveManager
  • ReplicationPort
  • NetworkNames
  • WitnessShareInUse

これらの一覧表示されたプロパティに対応する値を含めるには、コマンドで Status パラメーターを使用します。 Status パラメーターを使用しない場合は、これらのプロパティに関して返される値は空白になります。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-DatabaseAvailabilityGroup DAG1 | Format-List

この例では、DAG1 という DAG の基本プロパティを表示します。 コマンド出力の書式設定は一覧形式です。

例 2

Get-DatabaseAvailabilityGroup DAG2 -Status | Format-List

この例では、DAG2 という DAG のプロパティを表示します。 Status パラメータが含まれているため、このタスクには、操作中のサーバーの現在の一覧や現在プライマリ Active Manager の役割を保持しているサーバーなど、DAG2 のリアルタイムのステータス情報も表示されます。 さらに、監視サーバーやディレクトリ構成情報など、DAG のいくつかのプロパティも表示できます。 コマンド出力の書式設定は一覧形式です。

パラメーター

-DomainController

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

パラメーターのプロパティ

型:Fqdn
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Identity パラメーターには、クエリを実行する DAG の名前を指定します。

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:DatabaseAvailabilityGroupIdParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Status

適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

Status パラメーターは、Active Directory で追加情報のクエリを実行し、リアルタイムの状態情報を出力に含めるようにコマンドに指示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。