的版本 5 (V5) AWS Tools for PowerShell 已经发布！ 有关重大更改和迁移应用程序的信息，请参阅[迁移主题](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)。 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Directory Service 使用适用于 PowerShell V5 的工具的示例 以下代码示例向您展示了如何使用带 Directory Service的 AWS Tools for PowerShell V5 来执行操作和实现常见场景。 *操作*是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。 每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。 **Topics** + [操作](#actions) ## 操作 ### `Add-DSIpRoute` 以下代码示例演示了如何使用 `Add-DSIpRoute`。 **适用于 PowerShell V5 的工具** **示例 1：此命令移除分配给指定 Directory-id 的资源标签** ``` Add-DSIpRoute -DirectoryId d-123456ijkl -IpRoute @{CidrIp ="203.0.113.5/32"} -UpdateSecurityGroupForDirectoryController $true ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [AddIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Add-DSResourceTag` 以下代码示例演示了如何使用 `Add-DSResourceTag`。 **适用于 PowerShell V5 的工具** **示例 1：此命令将资源标签添加到指定的 Directory-id** ``` Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"} ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [AddTagsToResource](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Approve-DSTrust` 以下代码示例演示了如何使用 `Approve-DSTrust`。 **适用于 PowerShell V5 的工具** **示例 1：此示例调用指定的 Trustid 的 Di AWS rectory Service VerifyTrust API 操作。** ``` Approve-DSTrust -TrustId t-9067157123 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [VerifyTrust](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Confirm-DSSharedDirectory` 以下代码示例演示了如何使用 `Confirm-DSSharedDirectory`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [AcceptSharedDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Connect-DSDirectory` 以下代码示例演示了如何使用 `Connect-DSDirectory`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ConnectDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Deny-DSSharedDirectory` 以下代码示例演示了如何使用 `Deny-DSSharedDirectory`。 **适用于 PowerShell V5 的工具** **示例 1：此示例拒绝从目录所有者账户中发送的目录共享请求。** ``` Deny-DSSharedDirectory -SharedDirectoryId d-9067012345 ``` **输出**： ``` d-9067012345 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RejectSharedDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Disable-DSDirectoryShare` 以下代码示例演示了如何使用 `Disable-DSDirectoryShare`。 **适用于 PowerShell V5 的工具** **示例 1：此示例停止目录所有者和使用者账户之间的目录共享。** ``` Disable-DSDirectoryShare -DirectoryId d-123456ijkl -UnshareTarget_Id 123456784321 -UnshareTarget_Type ACCOUNT ``` **输出**： ``` d-9067012345 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UnshareDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Disable-DSLDAPS` 以下代码示例演示了如何使用 `Disable-DSLDAPS`。 **适用于 PowerShell V5 的工具** **示例 1：此示例停用对指定目录的 LDAP 安全调用。** ``` Disable-DSLDAPS -DirectoryId d-123456ijkl -Type Client ``` + 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V5)》**中的 [DisableLDAPS](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Disable-DSRadius` 以下代码示例演示了如何使用 `Disable-DSRadius`。 **适用于 PowerShell V5 的工具** **示例 1：此示例禁用为 AD Connector 或 Microsoft AD 目录配置的 RADIUS 服务器。** ``` Disable-DSRadius -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DisableRadius](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Disable-DSSso` 以下代码示例演示了如何使用 `Disable-DSSso`。 **适用于 PowerShell V5 的工具** **示例 1：此示例为目录禁用单点登录。** ``` Disable-DSSso -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DisableSso](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Enable-DSDirectoryShare` 以下代码示例演示了如何使用 `Enable-DSDirectoryShare`。 **适用于 PowerShell V5 的工具** **示例 1：此示例使用 Handshake 方法与另一个 AWS 账户共享您 AWS 账户中的指定目录。** ``` Enable-DSDirectoryShare -DirectoryId d-123456ijkl -ShareTarget_Id 123456784321 -ShareMethod HANDSHAKE -ShareTarget_Type ACCOUNT ``` **输出**： ``` d-9067012345 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ShareDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Enable-DSLDAPS` 以下代码示例演示了如何使用 `Enable-DSLDAPS`。 **适用于 PowerShell V5 的工具** **示例 1：此示例激活特定目录的开关以始终使用 LDAP 安全调用。** ``` Enable-DSLDAPS -DirectoryId d-123456ijkl -Type Client ``` + 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet Reference (V5)》**中的 [EnableLDAPS](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Enable-DSRadius` 以下代码示例演示了如何使用 `Enable-DSRadius`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [EnableRadius](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Enable-DSSso` 以下代码示例演示了如何使用 `Enable-DSSso`。 **适用于 PowerShell V5 的工具** **示例 1：此示例为目录启用单点登录。** ``` Enable-DSSso -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [EnableSso](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSCertificate` 以下代码示例演示了如何使用 `Get-DSCertificate`。 **适用于 PowerShell V5 的工具** **示例 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. ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeCertificate](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSCertificateList` 以下代码示例演示了如何使用 `Get-DSCertificateList`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSConditionalForwarder` 以下代码示例演示了如何使用 `Get-DSConditionalForwarder`。 **适用于 PowerShell V5 的工具** **示例 1：此命令获取给定 Directory-id 的所有已配置条件转发服务器。** ``` Get-DSConditionalForwarder -DirectoryId d-123456ijkl ``` **输出**： ``` DnsIpAddrs RemoteDomainName ReplicationScope ---------- ---------------- ---------------- {172.31.77.239} contoso.com Domain ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeConditionalForwarders](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSDirectory` 以下代码示例演示了如何使用 `Get-DSDirectory`。 **适用于 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 参考 (V* 5) [DescribeDirectories](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSDirectoryLimit` 以下代码示例演示了如何使用 `Get-DSDirectoryLimit`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [GetDirectoryLimits](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSDomainControllerList` 以下代码示例演示了如何使用 `Get-DSDomainControllerList`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeDomainControllers](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSEventTopic` 以下代码示例演示了如何使用 `Get-DSEventTopic`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeEventTopics](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSIpRouteList` 以下代码示例演示了如何使用 `Get-DSIpRouteList`。 **适用于 PowerShell V5 的工具** **示例 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 : ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSLDAPSSetting` 以下代码示例演示了如何使用 `Get-DSLDAPSSetting`。 **适用于 PowerShell V5 的工具** **示例 1：此示例描述指定目录的 LDAP 安全性状态。** ``` Get-DSLDAPSSetting -DirectoryId d-123456ijkl ``` **输出**： ``` LastUpdatedDateTime LDAPSStatus LDAPSStatusReason ------------------- ----------- ----------------- 4/15/2020 6:51:03 PM Enabled LDAPS is enabled successfully. ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考文档 (V* 5) LDAPSSettings 中的[描述](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `Get-DSLogSubscriptionList` 以下代码示例演示了如何使用 `Get-DSLogSubscriptionList`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListLogSubscriptions](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSResourceTag` 以下代码示例演示了如何使用 `Get-DSResourceTag`。 **适用于 PowerShell V5 的工具** **示例 1：此命令获取指定目录的所有标签。** ``` Get-DSResourceTag -ResourceId d-123456ijkl ``` **输出**： ``` Key Value --- ----- myTag myTagValue ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSSchemaExtension` 以下代码示例演示了如何使用 `Get-DSSchemaExtension`。 **适用于 PowerShell V5 的工具** **示例 1：此示例列出应用于某一 Microsoft AD 目录的所有架构扩展。** ``` 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ListSchemaExtensions](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSSharedDirectory` 以下代码示例演示了如何使用 `Get-DSSharedDirectory`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeSharedDirectories](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSSnapshot` 以下代码示例演示了如何使用 `Get-DSSnapshot`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DescribeSnapshots](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSSnapshotLimit` 以下代码示例演示了如何使用 `Get-DSSnapshotLimit`。 **适用于 PowerShell V5 的工具** **示例 1：此命令获取指定目录的手动快照限制。** ``` Get-DSSnapshotLimit -DirectoryId d-123456ijkl ``` **输出**： ``` ManualSnapshotsCurrentCount ManualSnapshotsLimit ManualSnapshotsLimitReached --------------------------- -------------------- --------------------------- 0 5 False ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [GetSnapshotLimits](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Get-DSTrust` 以下代码示例演示了如何使用 `Get-DSTrust`。 **适用于 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 参考 (V* 5) [DescribeTrusts](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSAlias` 以下代码示例演示了如何使用 `New-DSAlias`。 **适用于 PowerShell V5 的工具** **示例 1：此命令为目录创建一个别名并将此别名分配给指定的 directory-id。** ``` New-DSAlias -DirectoryId d-123456ijkl -Alias MyOrgName ``` **输出**： ``` Alias DirectoryId ----- ----------- myorgname d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateAlias](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSComputer` 以下代码示例演示了如何使用 `New-DSComputer`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateComputer](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSConditionalForwarder` 以下代码示例演示了如何使用 `New-DSConditionalForwarder`。 **适用于 PowerShell V5 的工具** **示例 1：此示例在指定的 Di AWS rectory-ID 中创建条件转发器。** ``` New-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.10.56 -RemoteDomainName contoso.com ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSDirectory` 以下代码示例演示了如何使用 `New-DSDirectory`。 **适用于 PowerShell V5 的工具** **示例 1：此示例创建一个新的 Simple AD 目录。** ``` New-DSDirectory -Name corp.example.com -Password $Password -Size Small -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSLogSubscription` 以下代码示例演示了如何使用 `New-DSLogSubscription`。 **适用于 PowerShell V5 的工具** **示例 1：此示例创建了一个订阅，用于将实时 Directory Service 域控制器安全日志转发到您的指定的 Amazon CloudWatch 日志组 AWS 账户。** ``` New-DSLogSubscription -DirectoryId d-123456ijkl -LogGroupName /aws/directoryservice/d-123456ijkl-lan2.example.com ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateLogSubscription](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSMicrosoftAD` 以下代码示例演示了如何使用 `New-DSMicrosoftAD`。 **适用于 PowerShell V5 的工具** **示例 1：此示例在中创建了新的 Microsoft 广告目录 AWS 云。** ``` New-DSMicrosoftAD -Name corp.example.com -Password $Password -edition Standard -VpcSettings_VpcId vpc-123459d -VpcSettings_SubnetIds subnet-1234kkaa,subnet-5678ffbb ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) 中的 A [CreateMicrosoftD](https://docs.aws.amazon.com/powershell/v5/reference)。 ### `New-DSSnapshot` 以下代码示例演示了如何使用 `New-DSSnapshot`。 **适用于 PowerShell V5 的工具** **示例 1：此示例创建目录快照** ``` New-DSSnapshot -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `New-DSTrust` 以下代码示例演示了如何使用 `New-DSTrust`。 **适用于 PowerShell V5 的工具** **示例 1：此示例在您的托管 Microsoft AD 目录和现有的本地 AWS 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CreateTrust](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Register-DSCertificate` 以下代码示例演示了如何使用 `Register-DSCertificate`。 **适用于 PowerShell V5 的工具** **示例 1：此示例为受保护的 LDAP 连接注册证书。** ``` $Certificate = Get-Content contoso.cer -Raw Register-DSCertificate -DirectoryId d-123456ijkl -CertificateData $Certificate ``` **输出**： ``` c-906731e350 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RegisterCertificate](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Register-DSEventTopic` 以下代码示例演示了如何使用 `Register-DSEventTopic`。 **适用于 PowerShell V5 的工具** **示例 1：此示例将目录作为发布者与 SNS 主题相关联。** ``` Register-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RegisterEventTopic](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSConditionalForwarder` 以下代码示例演示了如何使用 `Remove-DSConditionalForwarder`。 **适用于 PowerShell V5 的工具** **示例 1：此示例删除已为您的 D AWS irecotry 设置的条件转发器。** ``` Remove-DSConditionalForwarder -DirectoryId d-123456ijkl -RemoteDomainName contoso.com ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSDirectory` 以下代码示例演示了如何使用 `Remove-DSDirectory`。 **适用于 PowerShell V5 的工具** **示例 1：此示例删除 AWS 目录服务目录（简单 AD/Microsoft AD/AD 连接器）** ``` Remove-DSDirectory -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteDirectory](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSIpRoute` 以下代码示例演示了如何使用 `Remove-DSIpRoute`。 **适用于 PowerShell V5 的工具** **示例 1：此命令从 Directory-id 的已配置 IP 路由中移除指定的 IP。** ``` Remove-DSIpRoute -DirectoryId d-123456ijkl -CidrIp 203.0.113.5/32 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RemoveIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSLogSubscription` 以下代码示例演示了如何使用 `Remove-DSLogSubscription`。 **适用于 PowerShell V5 的工具** **示例 1：此命令移除指定 Directory-id 的日志订阅** ``` Remove-DSLogSubscription -DirectoryId d-123456ijkl ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteLogSubscription](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSResourceTag` 以下代码示例演示了如何使用 `Remove-DSResourceTag`。 **适用于 PowerShell V5 的工具** **示例 1：此命令移除分配给指定 Directory-id 的资源标签** ``` Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RemoveTagsFromResource](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSSnapshot` 以下代码示例演示了如何使用 `Remove-DSSnapshot`。 **适用于 PowerShell V5 的工具** **示例 1：此示例移除手动创建的快照。** ``` Remove-DSSnapshot -SnapshotId s-9068b488kc ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Remove-DSTrust` 以下代码示例演示了如何使用 `Remove-DSTrust`。 **适用于 PowerShell V5 的工具** **示例 1：此示例删除了您的 AWS 托管 AD 目录与外部域之间现有的信任关系。** ``` Get-DSTrust -DirectoryId d-123456ijkl -Select Trusts.TrustId | Remove-DSTrust ``` **输出**： ``` t-9067157123 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeleteTrust](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Reset-DSUserPassword` 以下代码示例演示了如何使用 `Reset-DSUserPassword`。 **适用于 PowerShell V5 的工具** **示例 1：此示例重置了在 Microsoft AD AWS 托管或 Simple AD Directory ADUser 中命名的 Active Direcotry 用户的密码** ``` Reset-DSUserPassword -UserName ADuser -DirectoryId d-123456ijkl -NewPassword $Password ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [ResetUserPassword](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Restore-DSFromSnapshot` 以下代码示例演示了如何使用 `Restore-DSFromSnapshot`。 **适用于 PowerShell V5 的工具** **示例 1：此示例使用现有的目录快照还原目录。** ``` Restore-DSFromSnapshot -SnapshotId s-9068b488kc ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [RestoreFromSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Set-DSDomainControllerCount` 以下代码示例演示了如何使用 `Set-DSDomainControllerCount`。 **适用于 PowerShell V5 的工具** **示例 1：此示例将指定 directory-id 的域控制器数量设置为 3。** ``` Set-DSDomainControllerCount -DirectoryId d-123456ijkl -DesiredNumber 3 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateNumberOfDomainControllers](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Start-DSSchemaExtension` 以下代码示例演示了如何使用 `Start-DSSchemaExtension`。 **适用于 PowerShell V5 的工具** **示例 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 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [StartSchemaExtension](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Stop-DSSchemaExtension` 以下代码示例演示了如何使用 `Stop-DSSchemaExtension`。 **适用于 PowerShell V5 的工具** **示例 1：此示例对 Microsoft AD 目录取消正在进行的架构扩展。** ``` Stop-DSSchemaExtension -DirectoryId d-123456ijkl -SchemaExtensionId e-9067306643 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [CancelSchemaExtension](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Unregister-DSCertificate` 以下代码示例演示了如何使用 `Unregister-DSCertificate`。 **适用于 PowerShell V5 的工具** **示例 1：此示例从系统中删除为受保护的 LDAP 连接注册的证书。** ``` Unregister-DSCertificate -DirectoryId d-123456ijkl -CertificateId c-906731e34f ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeregisterCertificate](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Unregister-DSEventTopic` 以下代码示例演示了如何使用 `Unregister-DSEventTopic`。 **适用于 PowerShell V5 的工具** **示例 1：此示例取消指定的目录作为指定 SNS 主题的发布者。** ``` Unregister-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [DeregisterEventTopic](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Update-DSConditionalForwarder` 以下代码示例演示了如何使用 `Update-DSConditionalForwarder`。 **适用于 PowerShell V5 的工具** **示例 1：此示例更新已为您的 AWS 目录设置的条件转发器。** ``` Update-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.16.108 -RemoteDomainName contoso.com ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Update-DSRadius` 以下代码示例演示了如何使用 `Update-DSRadius`。 **适用于 PowerShell V5 的工具** **示例 1：此示例更新 AD Connector 或 Microsoft AD 目录的 RADIUS 服务器信息。** ``` Update-DSRadius -DirectoryId d-123456ijkl -RadiusSettings_RadiusRetry 3 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateRadius](https://docs.aws.amazon.com/powershell/v5/reference)中的。 ### `Update-DSTrust` 以下代码示例演示了如何使用 `Update-DSTrust`。 **适用于 PowerShell V5 的工具** **示例 1：此示例将指定信任 ID 的 SelectiveAuth 参数从 “已禁用” 更新为 “启用”。** ``` Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled ``` **输出**： ``` RequestId TrustId --------- ------- 138864a7-c9a8-4ad1-a828-eae479e85b45 t-9067157123 ``` + 有关 API 的详细信息，请参阅 *AWS Tools for PowerShell Cmdlet 参考 (V* 5) [UpdateTrust](https://docs.aws.amazon.com/powershell/v5/reference)中的。