View a markdown version of this page

Directory Service exemplos usando ferramentas para PowerShell V5 - AWS Exemplos de código SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Directory Service exemplos usando ferramentas para PowerShell V5

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o Ferramentas da AWS para PowerShell V5 com Directory Service.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar Add-DSIpRoute.

Ferramentas para PowerShell V5

Exemplo 1: Esse comando remove a etiqueta de recurso atribuída ao especificado Directory-id 

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

  • Para obter detalhes sobre a API, consulte AddIpRoutes Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Add-DSResourceTag.

Ferramentas para PowerShell V5

Exemplo 1: Esse comando adiciona a tag de recurso ao especificado Directory-id 

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

  • Para obter detalhes sobre a API, consulte AddTagsToResource Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Approve-DSTrust.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo chama a operação da VerifyTrust API AWS Directory Service para o Trustid especificado. 

Approve-DSTrust -TrustId t-9067157123

  • Para obter detalhes sobre a API, consulte VerifyTrust Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Confirm-DSSharedDirectory.

Ferramentas para PowerShell V5

Exemplo 1: Esse exemplo aceita uma solicitação de compartilhamento de diretórios enviada pelo proprietário do diretório Conta da AWS. 

Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345

Saída:

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

  • Para obter detalhes sobre a API, consulte AcceptSharedDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Connect-DSDirectory.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo cria um AD Connector para conexão com um diretório on-premises.

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

  • Para obter detalhes sobre a API, consulte ConnectDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Deny-DSSharedDirectory.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo rejeita uma solicitação de compartilhamento de diretório que foi enviada da conta do proprietário do diretório.

Deny-DSSharedDirectory -SharedDirectoryId d-9067012345

Saída:

d-9067012345

  • Para obter detalhes sobre a API, consulte RejectSharedDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Disable-DSDirectoryShare.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo interrompe o compartilhamento de diretório entre o proprietário do diretório e a conta de consumidor.

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

Saída:

d-9067012345

  • Para obter detalhes sobre a API, consulte UnshareDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Disable-DSLDAPS.

Ferramentas para PowerShell V5

Exemplo 1:esse exemplo desativa as chamadas de segurança de LDAP para o diretório especificado.

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

  • Consulte detalhes da API em DisableLDAPS na Referência de cmdlet do Ferramentas da AWS para PowerShell (V5).

O código de exemplo a seguir mostra como usar Disable-DSRadius.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo desativa o servidor RADIUS configurado para um diretório do AD Connector ou do Microsoft AD.

Disable-DSRadius -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte DisableRadius Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Disable-DSSso.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo desativa o login único para um diretório.

Disable-DSSso -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte DisableSso Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Enable-DSDirectoryShare.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo compartilha um diretório especificado em sua AWS conta com outra AWS conta usando o método Handshake. 

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

Saída:

d-9067012345

  • Para obter detalhes sobre a API, consulte ShareDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Enable-DSLDAPS.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo ativa a opção para o diretório especificado para sempre usar chamadas seguras LDAP.

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

  • Consulte detalhes da API em EnableLDAPS na Referência de cmdlet do Ferramentas da AWS para PowerShell (V5).

O código de exemplo a seguir mostra como usar Enable-DSRadius.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo habilita a autenticação multifator (MFA) com a configuração do servidor RADIUS fornecida para um diretório do AD Connector ou do Microsoft AD.

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

  • Para obter detalhes sobre a API, consulte EnableRadius Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Enable-DSSso.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo ativa o login único para um diretório. 

Enable-DSSso -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte EnableSso Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSCertificate.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo exibe informações sobre o certificado registrado para uma conexão LDAP segura.

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

Saída:

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.

  • Para obter detalhes sobre a API, consulte DescribeCertificate Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSCertificateList.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo lista todos os certificados registrados para uma conexão LDAP segura para o diretório especificado.

Get-DSCertificateList -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte ListCertificates Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSConditionalForwarder.

Ferramentas para PowerShell V5

Exemplo 1: Este comando obtém todos os encaminhadores condicionais configurados de um dado. Directory-id 

Get-DSConditionalForwarder -DirectoryId d-123456ijkl

Saída:

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

O código de exemplo a seguir mostra como usar Get-DSDirectory.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém informações sobre os diretórios que pertencem a essa conta.

Get-DSDirectory | Select-Object DirectoryId, Name, DnsIpAddrs, Type

Saída:

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

  • Para obter detalhes sobre a API, consulte DescribeDirectories Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSDirectoryLimit.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo mostra as informações de limite de diretórios da região us-east-1.

Get-DSDirectoryLimit -Region us-east-1

Saída:

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

  • Para obter detalhes sobre a API, consulte GetDirectoryLimits Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSDomainControllerList.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém a lista detalhada dos controladores de domínio lançados para o ID de diretório mencionado.

Get-DSDomainControllerList -DirectoryId d-123456ijkl

Saída:

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

O código de exemplo a seguir mostra como usar Get-DSEventTopic.

Ferramentas para PowerShell V5

Exemplo 1: esse comando mostra informações do tópico do SNS configurado para notificação enquanto o status do diretório é alterado.

Get-DSEventTopic -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte DescribeEventTopics Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSIpRouteList.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém os blocos de endereços IP públicos configurados no roteamento IP do diretório.

Get-DSIpRouteList -DirectoryId d-123456ijkl

Saída:

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 :

  • Para obter detalhes sobre a API, consulte ListIpRoutes Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSLDAPSSetting.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo descreve o status da segurança LDAP do diretório especificado.

Get-DSLDAPSSetting -DirectoryId d-123456ijkl

Saída:

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

  • Consulte detalhes da API em DescribeLDAPSSettings na Referência de cmdlet do Ferramentas da AWS para PowerShell (V5).

O código de exemplo a seguir mostra como usar Get-DSLogSubscriptionList.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém as informações de assinaturas de log do ID do diretório especificado

Get-DSLogSubscriptionList -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte ListLogSubscriptions Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSResourceTag.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém todas as tags do diretório especificado.

Get-DSResourceTag -ResourceId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte ListTagsForResource Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSSchemaExtension.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo lista todas as extensões de esquema aplicadas a um Microsoft AD Directory.

Get-DSSchemaExtension -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte ListSchemaExtensions Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSSharedDirectory.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo obtém os diretórios compartilhados da sua conta AWS 

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

Saída:

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

O código de exemplo a seguir mostra como usar Get-DSSnapshot.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém informações sobre os snapshots do diretório especificado que pertencem a essa conta.

Get-DSSnapshot -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte DescribeSnapshots Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSSnapshotLimit.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém os limites manuais de snapshot para um diretório especificado.

Get-DSSnapshotLimit -DirectoryId d-123456ijkl

Saída:

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

  • Para obter detalhes sobre a API, consulte GetSnapshotLimits Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Get-DSTrust.

Ferramentas para PowerShell V5

Exemplo 1: esse comando obtém as informações das relações de confiança criadas para o ID de diretório especificado.

Get-DSTrust -DirectoryId d-123456abcd

Saída:

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

  • Para obter detalhes sobre a API, consulte DescribeTrusts Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSAlias.

Ferramentas para PowerShell V5

Exemplo 1: esse comando cria um alias para um diretório e atribui esse alias ao directory-id especificado.

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

Saída:

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

  • Para obter detalhes sobre a API, consulte CreateAlias Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSComputer.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo cria um objeto de computador do Active Directory.

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

Saída:

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

  • Para obter detalhes sobre a API, consulte CreateComputer Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSConditionalForwarder.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo cria um encaminhador condicional conforme especificado. AWS Directory-id 

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

O código de exemplo a seguir mostra como usar New-DSDirectory.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo cria um diretório do Simple AD.

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

  • Para obter detalhes sobre a API, consulte CreateDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSLogSubscription.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo cria uma assinatura para encaminhar registros de segurança do controlador de domínio do Directory Service em tempo real para o grupo de CloudWatch registros da Amazon especificado em seu Conta da AWS. 

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

  • Para obter detalhes sobre a API, consulte CreateLogSubscription Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSMicrosoftAD.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo cria um novo Microsoft AD Directory em Nuvem AWS. 

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

  • Para obter detalhes da API, consulte CreateMicrosoft AD in Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSSnapshot.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo cria um snapshot do diretório

New-DSSnapshot -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte CreateSnapshot Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar New-DSTrust.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo cria Two-Way uma confiança em toda a floresta entre seu diretório AWS gerenciado do Microsoft AD e o Microsoft Active Directory local existente. 

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

Saída:

t-9067157123

  • Para obter detalhes sobre a API, consulte CreateTrust Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Register-DSCertificate.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo registra um certificado para conexão LDAP segura.

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

Saída:

c-906731e350

  • Para obter detalhes sobre a API, consulte RegisterCertificate Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Register-DSEventTopic.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo associa um diretório como publicador a um tópico do SNS.

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

  • Para obter detalhes sobre a API, consulte RegisterEventTopic Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSConditionalForwarder.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo remove o encaminhador condicional que foi configurado para seu AWS diretório. 

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

O código de exemplo a seguir mostra como usar Remove-DSDirectory.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo exclui um AWS diretório de serviço de diretório (Simple AD/Microsoft AD/AD Connector) 

Remove-DSDirectory -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte DeleteDirectory Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSIpRoute.

Ferramentas para PowerShell V5

Exemplo 1: Esse comando remove o IP especificado das rotas IP configuradas do Directory-id. 

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

  • Para obter detalhes sobre a API, consulte RemoveIpRoutes Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSLogSubscription.

Ferramentas para PowerShell V5

Exemplo 1: Este comando remove a assinatura de log do especificado Directory-id 

Remove-DSLogSubscription -DirectoryId d-123456ijkl

  • Para obter detalhes sobre a API, consulte DeleteLogSubscription Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSResourceTag.

Ferramentas para PowerShell V5

Exemplo 1: Esse comando remove a etiqueta de recurso atribuída ao especificado Directory-id 

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

  • Para obter detalhes sobre a API, consulte RemoveTagsFromResource Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSSnapshot.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo remove o snapshot criado manualmente.

Remove-DSSnapshot -SnapshotId s-9068b488kc

  • Para obter detalhes sobre a API, consulte DeleteSnapshot Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Remove-DSTrust.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo remove a relação de confiança existente entre seu Diretório AD AWS gerenciado e um domínio externo. 

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

Saída:

t-9067157123

  • Para obter detalhes sobre a API, consulte DeleteTrust Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Reset-DSUserPassword.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo redefine a senha do usuário do Active Directory chamado ADUser no AWS Managed microsoft AD ou no Simple AD Directory 

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

  • Para obter detalhes sobre a API, consulte ResetUserPassword Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Restore-DSFromSnapshot.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo restaura um diretório usando um snapshot de diretório existente.

Restore-DSFromSnapshot -SnapshotId s-9068b488kc

  • Para obter detalhes sobre a API, consulte RestoreFromSnapshot Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Set-DSDomainControllerCount.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo define o número do controlador de domínio como 3 para o ID de diretório especificado.

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

O código de exemplo a seguir mostra como usar Start-DSSchemaExtension.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo aplica uma extensão de esquema a um diretório do Microsoft AD.

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

Saída:

e-9067306643

  • Para obter detalhes sobre a API, consulte StartSchemaExtension Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Stop-DSSchemaExtension.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo cancela uma extensão de esquema em andamento para um diretório do Microsoft AD.

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

  • Para obter detalhes sobre a API, consulte CancelSchemaExtension Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Unregister-DSCertificate.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo exclui do sistema o certificado que foi registrado para uma conexão LDAP segura.

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

  • Para obter detalhes sobre a API, consulte DeregisterCertificate Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Unregister-DSEventTopic.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo remove o diretório especificado como um publicador para o tópico do SNS especificado.

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

  • Para obter detalhes sobre a API, consulte DeregisterEventTopic Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Update-DSConditionalForwarder.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo atualiza um encaminhador condicional que foi configurado para seu AWS diretório. 

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

O código de exemplo a seguir mostra como usar Update-DSRadius.

Ferramentas para PowerShell V5

Exemplo 1: esse exemplo atualiza as informações do servidor RADIUS para um diretório do AD Connector ou do Microsoft AD.

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

  • Para obter detalhes sobre a API, consulte UpdateRadius Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

O código de exemplo a seguir mostra como usar Update-DSTrust.

Ferramentas para PowerShell V5

Exemplo 1: Este exemplo atualiza o SelectiveAuth parâmetro do trust-id especificado de Desativado para Ativado. 

Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled

Saída:

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

  • Para obter detalhes sobre a API, consulte UpdateTrust Ferramentas da AWS para PowerShell Cmdlet Reference (V5).