Get-ActiveSyncDeviceClass
このコマンドレットは、オンプレミスの Exchange およびクラウド ベースのサービスで使用できます。 一部のパラメーターおよび設定は、いずれかの環境専用となっている場合があります。
Get-ActiveSyncDeviceClass コマンドレットを使用して、組織に接続されている ActiveSync デバイスの一覧を取得します。 このコマンドレットは、モバイル デバイスの種類とモデル情報を返します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-ActiveSyncDeviceClass
[[-Identity] <ActiveSyncDeviceClassIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-SortBy <String>]
[<CommonParameters>]
説明
このコマンドレットを使用すると、携帯電話やモバイル デバイスの一覧を種類別に表示できます。 たとえば、組織内のすべての Android モバイル デジタル デバイスの一覧、または組織内のすべてのWindows Phoneデバイスの一覧を返すことができます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-ActiveSyncDeviceClass -Filter "DeviceType -eq 'WP'"
この例では、すべての Windows Phone の一覧を返します。
例 2
Get-ActiveSyncDeviceClass | group-object -Property DeviceType
この例では、組織内のすべてのデバイスの種類と種類ごとのデバイスの数を一覧表示します。
パラメーター
-DomainController
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
Filter パラメーターは、OPATH 構文を使用して、指定したプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"
を使用します。
- OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、
$true
、$false
、または$null
) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。 - Property はフィルタリング可能なプロパティです。
- ComparisonOperator は OPATH 比較演算子です (たとえば
-eq
、等しい場合や-like
文字列比較の場合)。 比較演算子の詳細については、「about_Comparison_Operators」を参照してください。 - Value は、検索するプロパティ値です。 テキスト値と変数を一重引用符 (
'Value'
または'$Variable'
) で囲みます。 変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。 たとえば、'$User'
の代わりに'$($User -Replace "'","''")'
を使用します。 整数またはシステム値を引用符で囲まないでください (代わりに、500
、$true
、$false
など$null
)。
論理演算子 -and
および -or
を使用すると、複数の検索条件を連結することができます。 たとえば、"Criteria1 -and Criteria2"
または "(Criteria1 -and Criteria2) -or Criteria3"
です。
Exchange の OPATH フィルターの詳細については、「 その他の OPATH 構文情報」を参照してください。
次のプロパティによってフィルター処理できます。
- DeviceModel
- DeviceType
- LastUpdateTime
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity パラメーターは、表示する ActiveSync デバイス クラスを指定します。 ActiveSync デバイス クラスを一意に識別する任意の値を使用できます。 例:
- 名前
- 識別名 (DN)
- GUID
Type: | ActiveSyncDeviceClassIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SortBy
SortBy パラメーターは、結果を並べ替えるためのプロパティを指定します。 並べ替えの基準にできるのは、一度に 1 つのプロパティのみです。 結果は昇順で並べ替えられます。
既定のビューに並べ替えるプロパティが含まれていない場合は、 コマンドを で | Format-Table -Auto Property1,Property2,...PropertyX
追加できます。 をクリックして、表示するすべてのプロパティを含む新しいビューを作成します。 プロパティ名にはワイルドカード (*) がサポートされています。
以下のプロパティで並べ替えることができます。
- DeviceModel
- DeviceType
- LastUpdateTime
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。