Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Tools for PowerShell V5 を使用した Kinesis の例
次のコード例は、Kinesis で AWS Tools for PowerShell V5 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**Topics**
+ [アクション](#actions)
## アクション
### `Get-KINRecord`
次のコード例は、`Get-KINRecord` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: この例では、一連の 1 つ以上のレコードからデータを返して抽出する方法を示しています。Get-KINRecord に供給されたイテレータは、この例で変数 \$1records にキャプチャされるレコードの開始位置を決定します。その後、\$1records コレクションにインデックスを付けることで、個々のレコードにアクセスできます。レコード内のデータが UTF-8 でエンコードされたテキストであると仮定すると、最終コマンドは、オブジェクト内の MemoryStream からデータを抽出してテキストとしてコンソールに返す方法を示します。**
```
$records
$records = Get-KINRecord -ShardIterator "AAAAAAAAAAGIc....9VnbiRNaP"
```
**出力:**
```
MillisBehindLatest NextShardIterator Records
------------------ ----------------- -------
0 AAAAAAAAAAERNIq...uDn11HuUs {Key1, Key2}
```
```
$records.Records[0]
```
**出力:**
```
ApproximateArrivalTimestamp Data PartitionKey SequenceNumber
--------------------------- ---- ------------ --------------
3/7/2016 5:14:33 PM System.IO.MemoryStream Key1 4955986459776...931586
```
```
[Text.Encoding]::UTF8.GetString($records.Records[0].Data.ToArray())
```
**出力:**
```
test data from string
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[GetRecords](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Get-KINShardIterator`
次のコード例は、`Get-KINShardIterator` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定されたシャードと開始位置のシャードイテレータを返します。シャード識別子とシーケンス番号の詳細は、返されたストリームオブジェクトのシャードコレクションを参照することで、Get-KINStream コマンドレットの出力から取得できます。返されたイテレータを Get-KINRecord コマンドレットとともに使用して、シャード内のデータレコードをプルできます。**
```
Get-KINShardIterator -StreamName "mystream" -ShardId "shardId-000000000000" -ShardIteratorType AT_SEQUENCE_NUMBER -StartingSequenceNumber "495598645..."
```
**出力:**
```
AAAAAAAAAAGIc....9VnbiRNaP
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[GetShardIterator](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Get-KINStream`
次のコード例は、`Get-KINStream` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定されたストリームの詳細を返します。**
```
Get-KINStream -StreamName "mystream"
```
**出力:**
```
HasMoreShards : False
RetentionPeriodHours : 24
Shards : {}
StreamARN : arn:aws:kinesis:us-west-2:123456789012:stream/mystream
StreamName : mystream
StreamStatus : ACTIVE
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[DescribeStream](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `New-KINStream`
次のコード例は、`New-KINStream` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 新しいストリームを作成します。**
```
New-KINStream -StreamName "mystream" -ShardCount 1
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[CreateStream](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Remove-KINStream`
次のコード例は、`Remove-KINStream` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定されたストリームを削除します。コマンドを実行する前に確認を求められます。確認メッセージを非表示にするには -Force スイッチを使用します。**
```
Remove-KINStream -StreamName "mystream"
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[DeleteStream](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Write-KINRecord`
次のコード例は、`Write-KINRecord` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: -Text パラメータに指定された文字列を含むレコードを書き込みます。**
```
Write-KINRecord -Text "test data from string" -StreamName "mystream" -PartitionKey "Key1"
```
**例 2: 指定されたファイルに含まれるデータを含むレコードを書き込みます。ファイルはバイトのシーケンスとして扱われるため、テキストが含まれている場合は、このコマンドレットで使用する前に、必要なエンコードで記述する必要があります。**
```
Write-KINRecord -FilePath "C:\TestData.txt" -StreamName "mystream" -PartitionKey "Key2"
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[PutRecord](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**