文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Directory Service 使用 AWS SDKs程式碼範例
下列程式碼範例示範如何使用 AWS Directory Service 搭配 AWS 軟體開發套件 (SDK)。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
**其他資源**
+ **[Directory Service 管理指南](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/what_is.html)** – 有關 的詳細資訊 Directory Service。
+ **[Directory Service API 參考](https://docs.aws.amazon.com/directoryservice/latest/APIReference/Welcome.html)** – 所有可用 Directory Service 動作的詳細資訊。
+ **[AWS 開發人員中心](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** – 您可以依類別或全文搜尋篩選的程式碼範例。
+ **[AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)** – GitHub 儲存庫使用慣用語言的完整程式碼。包含設定和執行程式碼的指示。
**Contents**
+ [基本概念](directory-service_code_examples_basics.md)
+ [動作](directory-service_code_examples_actions.md)
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# Directory Service 使用 AWS SDKs的基本範例
下列程式碼範例示範如何 AWS Directory Service 搭配 AWS SDKs 使用 的基本概念。
**Contents**
+ [動作](directory-service_code_examples_actions.md)
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# Directory Service 使用 AWS SDKs的動作
下列程式碼範例示範如何使用 AWS SDKs執行個別 Directory Service 動作。每個範例均包含 GitHub 的連結，您可以在連結中找到設定和執行程式碼的相關說明。
下列範例僅包含最常使用的動作。如需完整清單，請參閱《[AWS Directory Service API 參考](https://docs.aws.amazon.com/directoryservice/latest/APIReference/Welcome.html)》。
**Topics**
+ [`DescribeDirectories`](directory-service_example_directory-service_DescribeDirectories_section.md)
+ [`DescribeTrusts`](directory-service_example_directory-service_DescribeTrusts_section.md)
# 搭配使用 `DescribeDirectories` 與 CLI
下列程式碼範例示範如何使用 `DescribeDirectories`。
------
#### [ CLI ]
**AWS CLI**
**取得您目錄的詳細資訊**
下列 `describe-directories` 範例顯示指定目錄的詳細資訊。
```
aws ds describe-directories \
--directory-id d-a1b2c3d4e5
```
輸出：
```
{
"DirectoryDescriptions": [
{
"DirectoryId": "d-a1b2c3d4e5",
"Name": "mydirectory.example.com",
"ShortName": "mydirectory",
"Size": "Small",
"Edition": "Standard",
"Alias": "d-a1b2c3d4e5",
"AccessUrl": "d-a1b2c3d4e5.awsapps.com",
"Stage": "Active",
"ShareStatus": "Shared",
"ShareMethod": "HANDSHAKE",
"ShareNotes": "These are my share notes",
"LaunchTime": "2019-07-08T15:33:46.327000-07:00",
"StageLastUpdatedDateTime": "2019-07-08T15:59:12.307000-07:00",
"Type": "SharedMicrosoftAD",
"SsoEnabled": false,
"DesiredNumberOfDomainControllers": 0,
"OwnerDirectoryDescription": {
"DirectoryId": "d-b2c3d4e5f6",
"AccountId": "123456789111",
"DnsIpAddrs": [
"203.113.0.248",
"203.113.0.253"
],
"VpcSettings": {
"VpcId": "vpc-a1b2c3d4",
"SubnetIds": [
"subnet-a1b2c3d4",
"subnet-d4c3b2a1"
],
"AvailabilityZones": [
"us-west-2a",
"us-west-2c"
]
}
}
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeDirectories](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-directories.html)。
------
#### [ PowerShell ]
**Tools for PowerShell V4**
**範例 1：此命令會取得屬於此帳戶的目錄的相關資訊。**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**輸出：**
```
DirectoryId Name DnsIpAddrs Type
----------- ---- ---------- ----
d-123456abcd abcd.example.com {172.31.74.189, 172.31.13.145} SimpleAD
d-123456efgh wifi.example.com {172.31.16.108, 172.31.10.56} ADConnector
d-123456ijkl lan2.example.com {172.31.10.56, 172.31.16.108} MicrosoftAD
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》**中的 [DescribeDirectories](https://docs.aws.amazon.com/powershell/v4/reference)。
**Tools for PowerShell V5**
**範例 1：此命令會取得屬於此帳戶的目錄的相關資訊。**
```
Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type
```
**輸出：**
```
DirectoryId Name DnsIpAddrs Type
----------- ---- ---------- ----
d-123456abcd abcd.example.com {172.31.74.189, 172.31.13.145} SimpleAD
d-123456efgh wifi.example.com {172.31.16.108, 172.31.10.56} ADConnector
d-123456ijkl lan2.example.com {172.31.10.56, 172.31.16.108} MicrosoftAD
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [DescribeDirectories](https://docs.aws.amazon.com/powershell/v5/reference)。
------
# 搭配使用 `DescribeTrusts` 與 CLI
下列程式碼範例示範如何使用 `DescribeTrusts`。
------
#### [ CLI ]
**AWS CLI**
**取得有關信任關係的詳細資訊**
下列 `describe-trusts` 範例顯示指定目錄之信任關係的詳細資訊。
```
aws ds describe-trusts \
--directory-id d-a1b2c3d4e5
```
輸出：
```
{
"Trusts": [
{
"DirectoryId": "d-a1b2c3d4e5",
"TrustId": "t-9a8b7c6d5e",
"RemoteDomainName": "other.example.com",
"TrustType": "Forest",
"TrustDirection": "Two-Way",
"TrustState": "Verified",
"CreatedDateTime": "2017-06-20T18:08:45.614000-07:00",
"LastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00",
"StateLastUpdatedDateTime": "2019-06-04T10:52:12.410000-07:00",
"SelectiveAuth": "Disabled"
}
]
}
```
+ 如需 API 詳細資訊，請參閱《AWS CLI 命令參考》**中的 [DescribeTrusts](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ds/describe-trusts.html)。
------
#### [ PowerShell ]
**Tools for PowerShell V4**
**範例 1：此命令會取得為指定之 directory-id 建立的信任關係資訊。**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**輸出：**
```
CreatedDateTime : 7/5/2019 4:55:42 AM
DirectoryId : d-123456abcd
LastUpdatedDateTime : 7/5/2019 4:56:04 AM
RemoteDomainName : contoso.com
SelectiveAuth : Disabled
StateLastUpdatedDateTime : 7/5/2019 4:56:04 AM
TrustDirection : One-Way: Incoming
TrustId : t-9067157123
TrustState : Created
TrustStateReason :
TrustType : Forest
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V4)》**中的 [DescribeTrusts](https://docs.aws.amazon.com/powershell/v4/reference)。
**Tools for PowerShell V5**
**範例 1：此命令會取得為指定之 directory-id 建立的信任關係資訊。**
```
Get-DSTrust -DirectoryId d-123456abcd
```
**輸出：**
```
CreatedDateTime : 7/5/2019 4:55:42 AM
DirectoryId : d-123456abcd
LastUpdatedDateTime : 7/5/2019 4:56:04 AM
RemoteDomainName : contoso.com
SelectiveAuth : Disabled
StateLastUpdatedDateTime : 7/5/2019 4:56:04 AM
TrustDirection : One-Way: Incoming
TrustId : t-9067157123
TrustState : Created
TrustStateReason :
TrustType : Forest
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [DescribeTrusts](https://docs.aws.amazon.com/powershell/v5/reference)。
------