

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](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)

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 o Tools for PowerShell V5
<a name="powershell_directory-service_code_examples"></a>

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.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `Add-DSIpRoute`
<a name="directory-service_AddIpRoutes_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse comando remove a tag de recurso atribuída ao ID de diretório especificado**  

```
Add-DSIpRoute -DirectoryId d-123456ijkl -IpRoute @{CidrIp ="203.0.113.5/32"} -UpdateSecurityGroupForDirectoryController $true
```
+  Para obter detalhes da API, consulte [AddIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Add-DSResourceTag`
<a name="directory-service_AddTagsToResource_powershell_topic"></a>

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 ID de diretório especificado**  

```
Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"}
```
+  Para obter detalhes da API, consulte [AddTagsToResource](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Approve-DSTrust`
<a name="directory-service_VerifyTrust_powershell_topic"></a>

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 da API, consulte [VerifyTrust](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Confirm-DSSharedDirectory`
<a name="directory-service_AcceptSharedDirectory_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo aceita uma solicitação de compartilhamento de diretório 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 da API, consulte [AcceptSharedDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Connect-DSDirectory`
<a name="directory-service_ConnectDirectory_powershell_topic"></a>

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 da API, consulte [ConnectDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Deny-DSSharedDirectory`
<a name="directory-service_RejectSharedDirectory_powershell_topic"></a>

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 da API, consulte [RejectSharedDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Disable-DSDirectoryShare`
<a name="directory-service_UnshareDirectory_powershell_topic"></a>

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 da API, consulte [UnshareDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Disable-DSLDAPS`
<a name="directory-service_DisableLDAPS_powershell_topic"></a>

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](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de cmdlet do Ferramentas da AWS para PowerShell (V5)*. 

### `Disable-DSRadius`
<a name="directory-service_DisableRadius_powershell_topic"></a>

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 da API, consulte [DisableRadius](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Disable-DSSso`
<a name="directory-service_DisableSso_powershell_topic"></a>

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 da API, consulte [DisableSso](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Enable-DSDirectoryShare`
<a name="directory-service_ShareDirectory_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo compartilha um diretório específico 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 da API, consulte [ShareDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Enable-DSLDAPS`
<a name="directory-service_EnableLDAPS_powershell_topic"></a>

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](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de cmdlet do Ferramentas da AWS para PowerShell (V5)*. 

### `Enable-DSRadius`
<a name="directory-service_EnableRadius_powershell_topic"></a>

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 da API, consulte [EnableRadius](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Enable-DSSso`
<a name="directory-service_EnableSso_powershell_topic"></a>

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 da API, consulte [EnableSso](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSCertificate`
<a name="directory-service_DescribeCertificate_powershell_topic"></a>

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 da API, consulte [DescribeCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSCertificateList`
<a name="directory-service_ListCertificates_powershell_topic"></a>

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 da API, consulte [ListCertificates](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSConditionalForwarder`
<a name="directory-service_DescribeConditionalForwarders_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse comando obtém todos os encaminhadores condicionais configurados de determinado ID de diretório.**  

```
Get-DSConditionalForwarder -DirectoryId d-123456ijkl
```
**Saída**:  

```
DnsIpAddrs      RemoteDomainName ReplicationScope
----------      ---------------- ----------------
{172.31.77.239} contoso.com      Domain
```
+  Para obter detalhes da API, consulte [DescribeConditionalForwarders](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSDirectory`
<a name="directory-service_DescribeDirectories_powershell_topic"></a>

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 da API, consulte [DescribeDirectories](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSDirectoryLimit`
<a name="directory-service_GetDirectoryLimits_powershell_topic"></a>

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 da API, consulte [GetDirectoryLimits](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSDomainControllerList`
<a name="directory-service_DescribeDomainControllers_powershell_topic"></a>

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
```
+  Para obter detalhes da API, consulte [DescribeDomainControllers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSEventTopic`
<a name="directory-service_DescribeEventTopics_powershell_topic"></a>

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 da API, consulte [DescribeEventTopics](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSIpRouteList`
<a name="directory-service_ListIpRoutes_powershell_topic"></a>

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 da API, consulte [ListIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSLDAPSSetting`
<a name="directory-service_DescribeLDAPSSettings_powershell_topic"></a>

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.
```
+  Para obter detalhes da API, consulte [Descrever LDAPSSettings](https://docs.aws.amazon.com/powershell/v5/reference) na *Referência de Ferramentas da AWS para PowerShell Cmdlet (V5)*. 

### `Get-DSLogSubscriptionList`
<a name="directory-service_ListLogSubscriptions_powershell_topic"></a>

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 da API, consulte [ListLogSubscriptions](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSResourceTag`
<a name="directory-service_ListTagsForResource_powershell_topic"></a>

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 da API, consulte [ListTagsForResource](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSSchemaExtension`
<a name="directory-service_ListSchemaExtensions_powershell_topic"></a>

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 da API, consulte [ListSchemaExtensions](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSSharedDirectory`
<a name="directory-service_DescribeSharedDirectories_powershell_topic"></a>

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
```
+  Para obter detalhes da API, consulte [DescribeSharedDirectories](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSSnapshot`
<a name="directory-service_DescribeSnapshots_powershell_topic"></a>

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 da API, consulte [DescribeSnapshots](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSSnapshotLimit`
<a name="directory-service_GetSnapshotLimits_powershell_topic"></a>

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 da API, consulte [GetSnapshotLimits](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Get-DSTrust`
<a name="directory-service_DescribeTrusts_powershell_topic"></a>

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 da API, consulte [DescribeTrusts](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSAlias`
<a name="directory-service_CreateAlias_powershell_topic"></a>

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 da API, consulte [CreateAlias](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSComputer`
<a name="directory-service_CreateComputer_powershell_topic"></a>

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 da API, consulte [CreateComputer](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSConditionalForwarder`
<a name="directory-service_CreateConditionalForwarder_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo cria um encaminhador condicional no ID de diretório especificado AWS .**  

```
New-DSConditionalForwarder -DirectoryId d-123456ijkl -DnsIpAddr 172.31.36.96,172.31.10.56 -RemoteDomainName contoso.com
```
+  Para obter detalhes da API, consulte [CreateConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSDirectory`
<a name="directory-service_CreateDirectory_powershell_topic"></a>

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 da API, consulte [CreateDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSLogSubscription`
<a name="directory-service_CreateLogSubscription_powershell_topic"></a>

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 da API, consulte [CreateLogSubscription](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSMicrosoftAD`
<a name="directory-service_CreateMicrosoftAD_powershell_topic"></a>

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 [CreateMicrosoftAD](https://docs.aws.amazon.com/powershell/v5/reference) em *Ferramentas da AWS para PowerShell Cmdlet Reference (V5)*. 

### `New-DSSnapshot`
<a name="directory-service_CreateSnapshot_powershell_topic"></a>

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 da API, consulte [CreateSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `New-DSTrust`
<a name="directory-service_CreateTrust_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: Este exemplo cria confiança bidirecional em toda a floresta entre seu diretório gerenciado AWS 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 da API, consulte [CreateTrust](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Register-DSCertificate`
<a name="directory-service_RegisterCertificate_powershell_topic"></a>

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 da API, consulte [RegisterCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Register-DSEventTopic`
<a name="directory-service_RegisterEventTopic_powershell_topic"></a>

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 da API, consulte [RegisterEventTopic](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSConditionalForwarder`
<a name="directory-service_DeleteConditionalForwarder_powershell_topic"></a>

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
```
+  Para obter detalhes da API, consulte [DeleteConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSDirectory`
<a name="directory-service_DeleteDirectory_powershell_topic"></a>

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ços de diretório (conector AD/Microsoft AD/AD simples)**  

```
Remove-DSDirectory -DirectoryId d-123456ijkl
```
+  Para obter detalhes da API, consulte [DeleteDirectory](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSIpRoute`
<a name="directory-service_RemoveIpRoutes_powershell_topic"></a>

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 de IP configuradas do ID do diretório.**  

```
Remove-DSIpRoute -DirectoryId d-123456ijkl -CidrIp 203.0.113.5/32
```
+  Para obter detalhes da API, consulte [RemoveIpRoutes](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSLogSubscription`
<a name="directory-service_DeleteLogSubscription_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse comando remove a assinatura de log do ID do diretório especificado**  

```
Remove-DSLogSubscription -DirectoryId d-123456ijkl
```
+  Para obter detalhes da API, consulte [DeleteLogSubscription](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSResourceTag`
<a name="directory-service_RemoveTagsFromResource_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: esse comando remove a tag de recurso atribuída ao ID de diretório especificado**  

```
Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag
```
+  Para obter detalhes da API, consulte [RemoveTagsFromResource](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSSnapshot`
<a name="directory-service_DeleteSnapshot_powershell_topic"></a>

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 da API, consulte [DeleteSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Remove-DSTrust`
<a name="directory-service_DeleteTrust_powershell_topic"></a>

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

**Ferramentas para PowerShell V5**  
**Exemplo 1: Esse exemplo remove a relação de confiança existente entre seu diretório AWS gerenciado do AD e um domínio externo.**  

```
Get-DSTrust -DirectoryId d-123456ijkl -Select Trusts.TrustId | Remove-DSTrust
```
**Saída**:  

```
t-9067157123
```
+  Para obter detalhes da API, consulte [DeleteTrust](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Reset-DSUserPassword`
<a name="directory-service_ResetUserPassword_powershell_topic"></a>

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 nomeado ADUser em AWS Managed microsoft AD ou Simple AD Directory**  

```
Reset-DSUserPassword -UserName ADuser -DirectoryId d-123456ijkl -NewPassword $Password
```
+  Para obter detalhes da API, consulte [ResetUserPassword](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Restore-DSFromSnapshot`
<a name="directory-service_RestoreFromSnapshot_powershell_topic"></a>

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 da API, consulte [RestoreFromSnapshot](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Set-DSDomainControllerCount`
<a name="directory-service_UpdateNumberOfDomainControllers_powershell_topic"></a>

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
```
+  Para obter detalhes da API, consulte [UpdateNumberOfDomainControllers](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Start-DSSchemaExtension`
<a name="directory-service_StartSchemaExtension_powershell_topic"></a>

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 da API, consulte [StartSchemaExtension](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Stop-DSSchemaExtension`
<a name="directory-service_CancelSchemaExtension_powershell_topic"></a>

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 da API, consulte [CancelSchemaExtension](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Unregister-DSCertificate`
<a name="directory-service_DeregisterCertificate_powershell_topic"></a>

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 da API, consulte [DeregisterCertificate](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Unregister-DSEventTopic`
<a name="directory-service_DeregisterEventTopic_powershell_topic"></a>

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 da API, consulte [DeregisterEventTopic](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Update-DSConditionalForwarder`
<a name="directory-service_UpdateConditionalForwarder_powershell_topic"></a>

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
```
+  Para obter detalhes da API, consulte [UpdateConditionalForwarder](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Update-DSRadius`
<a name="directory-service_UpdateRadius_powershell_topic"></a>

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 da API, consulte [UpdateRadius](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

### `Update-DSTrust`
<a name="directory-service_UpdateTrust_powershell_topic"></a>

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 da API, consulte [UpdateTrust](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 