AWS Directory Service Tools for PowerShell を使用した例

例 1: このコマンドは、指定された Directory-id に割り当てられたリソースタグを削除します。

Add-DSIpRoute -DirectoryId d-123456ijkl -IpRoute @{CidrIp ="203.0.113.5/32"} -UpdateSecurityGroupForDirectoryController $true

例 1: このコマンドは、指定された Directory-id にリソースタグを追加します。

Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"}

例 1: この例では、指定された Trustid の AWS Directory Service VerifyTrust API Wordオペレーションを呼び出します。

Approve-DSTrust -TrustId t-9067157123

例 1: この例では、ディレクトリ所有者から送信されたディレクトリ共有リクエストを受け入れます AWS アカウント。

Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345

出力:

CreatedDateTime     : 12/30/2019 4:20:27 AM
LastUpdatedDateTime : 12/30/2019 4:21:40 AM
OwnerAccountId      : 123456781234
OwnerDirectoryId    : d-123456ijkl
SharedAccountId     : 123456784321
SharedDirectoryId   : d-9067012345
ShareMethod         :
ShareNotes          : This is test sharing
ShareStatus         : Sharing

例 1: この例では、オンプレミスディレクトリに接続する AD Connector を作成します。

Connect-DSDirectory -Name contoso.com -ConnectSettings_CustomerUserName Administrator -Password $Password -ConnectSettings_CustomerDnsIp 172.31.36.96 -ShortName CONTOSO -Size Small -ConnectSettings_VpcId vpc-123459da -ConnectSettings_SubnetId subnet-1234ccaa, subnet-5678ffbb

例 1: この例では、ディレクトリ所有者アカウントから送信されたディレクトリ共有リクエストを拒否します。

Deny-DSSharedDirectory -SharedDirectoryId d-9067012345

出力:

d-9067012345

例 1: この例では、ディレクトリ所有者とコンシューマーアカウント間のディレクトリ共有を停止します。

Disable-DSDirectoryShare -DirectoryId d-123456ijkl -UnshareTarget_Id 123456784321 -UnshareTarget_Type ACCOUNT

出力:

d-9067012345

例 1: この例では、指定されたディレクトリの LDAP セキュアコールを非アクティブ化します。

Disable-DSLDAPS -DirectoryId d-123456ijkl -Type Client

例 1: この例では、AD Connector または Microsoft AD ディレクトリ用に設定された RADIUS サーバーを無効にします。

Disable-DSRadius -DirectoryId d-123456ijkl

例 1: この例では、ディレクトリのシングルサインオンを無効にします。

Disable-DSSso -DirectoryId d-123456ijkl

例 1: この例では、Handshake メソッドを使用して AWS 、アカウントの指定されたディレクトリを別の AWS アカウントと共有します。

Enable-DSDirectoryShare -DirectoryId d-123456ijkl -ShareTarget_Id 123456784321 -ShareMethod HANDSHAKE -ShareTarget_Type ACCOUNT

出力:

d-9067012345

例 1: この例では、特定のディレクトリのスイッチを有効にして、常に LDAP セキュアコールを使用します。

Enable-DSLDAPS -DirectoryId d-123456ijkl -Type Client

例 1: この例では、AD Connector または Microsoft AD ディレクトリ用に提供された RADIUS サーバー設定で多要素認証 (MFA) を有効にします。

Enable-DSRadius -DirectoryId d-123456ijkl 
-RadiusSettings_AuthenticationProtocol PAP 
-RadiusSettings_DisplayLabel Radius 
-RadiusSettings_RadiusPort 1812 
-RadiusSettings_RadiusRetry 4 
-RadiusSettings_RadiusServer 10.4.185.113 
-RadiusSettings_RadiusTimeout 50 
-RadiusSettings_SharedSecret wJalrXUtnFEMI

例 1: この例では、ディレクトリのシングルサインオンを有効にします。

Enable-DSSso -DirectoryId d-123456ijkl

例 1: この例では、保護された LDAP 接続に登録された証明書に関する情報を表示します。

Get-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f

出力:

CertificateId      : c-906731e34f
CommonName         : contoso-EC2AMAZ-CTGG2NM-CA
ExpiryDateTime     : 4/15/2025 6:34:15 PM
RegisteredDateTime : 4/15/2020 6:38:56 PM
State              : Registered
StateReason        : Certificate registered successfully.

例 1: この例では、指定されたディレクトリの保護された LDAP 接続に登録されているすべての証明書を一覧表示します。

Get-DSCertificateList -DirectoryId d-123456ijkl

出力:

CertificateId CommonName                 ExpiryDateTime       State
------------- ----------                 --------------       -----
c-906731e34f  contoso-EC2AMAZ-CTGG2NM-CA 4/15/2025 6:34:15 PM Registered

例 1: このコマンドは、指定された Directory-id のすべての設定済み条件付きフォワーダーを取得します。

Get-DSConditionalForwarder -DirectoryId d-123456ijkl

出力:

DnsIpAddrs      RemoteDomainName ReplicationScope
----------      ---------------- ----------------
{172.31.77.239} contoso.com      Domain

例 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

例 1: この例では、us-east-1 リージョンのディレクトリ制限情報をディスルペイします。

Get-DSDirectoryLimit -Region us-east-1

出力:

CloudOnlyDirectoriesCurrentCount : 1
CloudOnlyDirectoriesLimit        : 10
CloudOnlyDirectoriesLimitReached : False
CloudOnlyMicrosoftADCurrentCount : 1
CloudOnlyMicrosoftADLimit        : 20
CloudOnlyMicrosoftADLimitReached : False
ConnectedDirectoriesCurrentCount : 1
ConnectedDirectoriesLimit        : 10

例 1: このコマンドは、前述の directory-id に対して起動されたドメインコントローラーの詳細リストを取得します。

Get-DSDomainControllerList -DirectoryId d-123456ijkl

出力:

AvailabilityZone          : us-east-1b
DirectoryId               : d-123456ijkl
DnsIpAddr                 : 172.31.16.108
DomainControllerId        : dc-1234567aa6
LaunchTime                : 4/4/2019 4:53:43 AM
Status                    : Active
StatusLastUpdatedDateTime : 4/24/2019 1:37:54 PM
StatusReason              :
SubnetId                  : subnet-1234kkaa
VpcId                     : vpc-123459d

AvailabilityZone          : us-east-1d
DirectoryId               : d-123456ijkl
DnsIpAddr                 : 172.31.10.56
DomainControllerId        : dc-1234567aa7
LaunchTime                : 4/4/2019 4:53:43 AM
Status                    : Active
StatusLastUpdatedDateTime : 4/4/2019 5:14:31 AM
StatusReason              :
SubnetId                  : subnet-5678ffbb
VpcId                     : vpc-123459d

例 1: このコマンドは、ディレクトリステータスの変更中に通知用に設定された SNS トピックの情報を表示します。

Get-DSEventTopic -DirectoryId d-123456ijkl

出力:

CreatedDateTime : 12/13/2019 11:15:32 AM
DirectoryId     : d-123456ijkl
Status          : Registered
TopicArn        : arn:aws:sns:us-east-1:123456781234:snstopicname
TopicName       : snstopicname

例 1: このコマンドは、ディレクトリ IP ルーティングで設定されたパブリック IP アドレスブロックを取得します。

Get-DSIpRouteList -DirectoryId d-123456ijkl

出力:

AddedDateTime       : 12/13/2019 12:27:22 PM
CidrIp              : 203.0.113.5/32
Description         : Public IP of On-Prem DNS Server
DirectoryId         : d-123456ijkl
IpRouteStatusMsg    : Added
IpRouteStatusReason :

例 1: この例では、指定したディレクトリの LDAP セキュリティのステータスについて説明します。

Get-DSLDAPSSetting -DirectoryId d-123456ijkl

出力:

LastUpdatedDateTime  LDAPSStatus LDAPSStatusReason
-------------------  ----------- -----------------
4/15/2020 6:51:03 PM Enabled     LDAPS is enabled successfully.

例 1: このコマンドは、指定された directory-id のログサブスクリプション情報を取得します。

Get-DSLogSubscriptionList -DirectoryId d-123456ijkl

出力:

DirectoryId  LogGroupName                                        SubscriptionCreatedDateTime
-----------  ------------                                        ---------------------------
d-123456ijkl /aws/directoryservice/d-123456ijkl-lan2.example.com 12/14/2019 9:05:23 AM

例 1: このコマンドは、指定されたディレクトリのすべてのタグを取得します。

Get-DSResourceTag -ResourceId d-123456ijkl

出力:

Key   Value
---   -----
myTag myTagValue

例 1: この例では、Microsoft AD Directory に適用されるすべてのスキーマ拡張を一覧表示します。

Get-DSSchemaExtension -DirectoryId d-123456ijkl

出力:

Description                 : ManagedADSchemaExtension
DirectoryId                 : d-123456ijkl
EndDateTime                 : 4/12/2020 10:30:49 AM
SchemaExtensionId           : e-9067306643
SchemaExtensionStatus       : Completed
SchemaExtensionStatusReason : Schema updates are complete.
StartDateTime               : 4/12/2020 10:28:42 AM

例 1: この例では、 AWS アカウントの共有ディレクトリを取得します。

Get-DSSharedDirectory -OwnerDirectoryId d-123456ijkl -SharedDirectoryId d-9067012345

出力:

CreatedDateTime     : 12/30/2019 4:34:37 AM
LastUpdatedDateTime : 12/30/2019 4:35:22 AM
OwnerAccountId      : 123456781234
OwnerDirectoryId    : d-123456ijkl
SharedAccountId     : 123456784321
SharedDirectoryId   : d-9067012345
ShareMethod         : HANDSHAKE
ShareNotes          : This is a test Sharing
ShareStatus         : Shared

例 1: このコマンドは、このアカウントに属する指定されたディレクトリスナップショットに関する情報を取得します。

Get-DSSnapshot -DirectoryId d-123456ijkl

出力:

DirectoryId : d-123456ijkl
Name        :
SnapshotId  : s-9064bd1234
StartTime   : 12/13/2019 6:33:01 PM
Status      : Completed
Type        : Auto

DirectoryId : d-123456ijkl
Name        :
SnapshotId  : s-9064bb4321
StartTime   : 12/9/2019 9:48:11 PM
Status      : Completed
Type        : Auto

例 1: このコマンドは、指定されたディレクトリの手動スナップショット制限を取得します。

Get-DSSnapshotLimit -DirectoryId d-123456ijkl

出力:

ManualSnapshotsCurrentCount ManualSnapshotsLimit ManualSnapshotsLimitReached
--------------------------- -------------------- ---------------------------
0                           5                    False

例 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

例 1: このコマンドは、ディレクトリのエイリアスを作成し、指定された directory-id にエイリアスを割り当てます。

New-DSAlias -DirectoryId d-123456ijkl -Alias MyOrgName

出力:

Alias     DirectoryId
-----     -----------
myorgname d-123456ijkl

例 1: この例では、新しい Active Directory コンピュータオブジェクトを作成します。

New-DSComputer -DirectoryId d-123456ijkl -ComputerName ADMemberServer -Password $Password

出力:

ComputerAttributes                  ComputerId                                    ComputerName
------------------                  ----------                                    ------------
{WindowsSamName, DistinguishedName} S-1-5-21-1191241402-978882507-2717148213-1662 ADMemberServer

例 1: この例では、指定された AWS Directory-id に条件付きフォワーダーを作成します。

New-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.10.56 -RemoteDomainName contoso.com

例 1: この例では、新しい Simple AD ディレクトリを作成します。

New-DSDirectory -Name corp.example.com -Password $Password -Size Small -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb

例 1: この例では、サブスクリプションを作成して、ディレクトリサービスドメインコントローラーのセキュリティログを 内の指定された Amazon CloudWatch ロググループに転送します AWS アカウント。

New-DSLogSubscription -DirectoryId d-123456ijkl -LogGroupName /aws/directoryservice/d-123456ijkl-lan2.example.com

例 1: この例では、 に新しい Microsoft AD Directory を作成します AWS クラウド。

New-DSMicrosoftAD -Name corp.example.com -Password $Password -edition Standard -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb

例 1: この例ではディレクトリスナップショットを作成します

New-DSSnapshot -DirectoryId d-123456ijkl

例 1: この例では、 AWS マネージド Microsoft AD ディレクトリと既存のオンプレミス Microsoft Active Directory との間に双方向のフォレストワイド信頼を作成します。

New-DSTrust -DirectoryId d-123456ijkl -RemoteDomainName contoso.com -TrustDirection Two-Way -TrustType Forest -TrustPassword $Password -ConditionalForwarderIpAddr 172.31.36.96

出力:

t-9067157123

例 1: この例では、保護された LDAP 接続の証明書を登録します。

$Certificate = Get-Content contoso.cer -Raw
Register-DSCertificate -DirectoryId d-123456ijkl -CertificateData $Certificate

出力:

c-906731e350

例 1: この例では、ディレクトリをパブリッシャーとして SNS トピックに関連付けます。

Register-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname

例 1: この例では、 AWS Direcotry 用に設定された条件付きフォワーダーを削除します。

Remove-DSConditionalForwarder -DirectoryId d-123456ijkl -RemoteDomainName contoso.com

例 1: この例では、 AWS ディレクトリサービスディレクトリ (Simple AD/Microsoft AD/AD Connector) を削除します。

Remove-DSDirectory -DirectoryId d-123456ijkl

例 1: このコマンドは、ディレクトリ ID の設定済み IP ルートから指定された IP を削除します。

Remove-DSIpRoute -DirectoryId d-123456ijkl -CidrIp 203.0.113.5/32

例 1: このコマンドは、指定された Directory-id の Log Subscription を削除します。

Remove-DSLogSubscription -DirectoryId d-123456ijkl

例 1: このコマンドは、指定された Directory-id に割り当てられたリソースタグを削除します。

Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag

例 1: この例では、手動で作成されたスナップショットを削除します。

Remove-DSSnapshot -SnapshotId s-9068b488kc

例 1: この例では、 AWS マネージド AD Directory と外部ドメイン間の既存の信頼関係ヒップを削除します。

Get-DSTrust -DirectoryId d-123456ijkl -Select Trusts.TrustId | Remove-DSTrust

出力:

t-9067157123

例 1: この例では、 AWS Managed microsoft AD または Simple AD Directory で ADUser という名前の Active Direcotry ユーザーのパスワードをリセットします。

Reset-DSUserPassword -UserName ADuser -DirectoryId d-123456ijkl -NewPassword $Password

例 1: この例では、既存のディレクトリスナップショットを使用してディレクトリを復元します。

Restore-DSFromSnapshot -SnapshotId s-9068b488kc

例 1: この例では、指定された directory-id のドメインコントローラーの数を 3 に設定します。

Set-DSDomainControllerCount -DirectoryId d-123456ijkl -DesiredNumber 3

例 1: この例では、スキーマ拡張を Microsoft AD ディレクトリに適用します。

$ldif = Get-Content D:\Users\Username\Downloads\ExtendedSchema.ldf -Raw
Start-DSSchemaExtension -DirectoryId d-123456ijkl -CreateSnapshotBeforeSchemaExtension $true -Description ManagedADSchemaExtension -LdifContent $ldif

出力:

e-9067306643

例 1: この例では、Microsoft AD ディレクトリへの進行中のスキーマ拡張をキャンセルします。

Stop-DSSchemaExtension -DirectoryId d-123456ijkl -SchemaExtensionId e-9067306643

例 1: この例では、セキュリティで保護された LDAP 接続に登録された証明書をシステムから削除します。

Unregister-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f

例 1: この例では、指定された SNS トピックのパブリッシャーとして指定されたディレクトリを削除します。

Unregister-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname

例 1: この例では、 AWS ディレクトリ用に設定された条件付きフォワーダーを更新します。

Update-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.16.108 -RemoteDomainName contoso.com

例 1: この例では、AD Connector または Microsoft AD ディレクトリの RADIUS サーバー情報を更新します。

Update-DSRadius -DirectoryId d-123456ijkl -RadiusSettings_RadiusRetry 3

例 1: この例では、指定された trust-id の SelectiveAuth パラメータを 無効から有効に更新します。

Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled

出力:

RequestId                            TrustId
---------                            -------
138864a7-c9a8-4ad1-a828-eae479e85b45 t-9067157123