Ejemplos de Directory Service con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)
Acciones

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de Directory Service con las Herramientas para PowerShell V4

En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando Herramientas de AWS para PowerShell V4 con Directory Service.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Add-DSIpRoute.

Herramientas para PowerShell V4

Ejemplo 1: Este comando elimina la etiqueta de recurso asignada al Directory-id especificado.

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

  • Para obtener información sobre la API, consulte AddIpRoutes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Add-DSResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: Este comando añade la etiqueta de recurso asignada al Directory-id especificado.

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

  • Para obtener información sobre la API, consulte AddTagsToResource en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Approve-DSTrust.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se llama a la operación de la API VerifyTrust de AWS Directory Service para el Trustid especificado.

Approve-DSTrust -TrustId t-9067157123

  • Para obtener información sobre la API, consulte VerifyTrust en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Confirm-DSSharedDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se acepta una solicitud de uso compartido del directorio enviada desde la Cuenta de AWS del propietario del directorio.

Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345

Salida:

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 obtener información sobre la API, consulte AcceptSharedDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Connect-DSDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un Conector AD para conectarse a un directorio en las instalaciones.

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 obtener información sobre la API, consulte ConnectDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Deny-DSSharedDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se rechaza una solicitud de uso compartido del directorio que se envió desde la cuenta del propietario del directorio.

Deny-DSSharedDirectory -SharedDirectoryId d-9067012345

Salida:

d-9067012345

  • Para obtener información sobre la API, consulte RejectSharedDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSDirectoryShare.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se detiene el uso compartido de directorio entre el propietario del directorio y la cuenta del consumidor.

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

Salida:

d-9067012345

  • Para obtener información sobre la API, consulte UnshareDirectory la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSLDAPS.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se desactivan las llamadas LDAP seguras para el directorio especificado.

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

  • Para obtener información sobre la API, consulte DisableLDAPS en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSRadius.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se deshabilita el servidor RADIUS configurado para un Conector AD o un directorio de Microsoft AD.

Disable-DSRadius -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte DisableRadius en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSSso.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se deshabilita el inicio de sesión único en un directorio.

Disable-DSSso -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte DisableSso en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSDirectoryShare.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se comparte un directorio especificado de su cuenta de AWS con otra cuenta de AWS mediante el método de establecimiento de comunicación.

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

Salida:

d-9067012345

  • Para obtener información sobre la API, consulte ShareDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSLDAPS.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se activa el modificador para que el directorio especificado utilice siempre llamadas LDAP seguras.

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

  • Para obtener información sobre la API, consulte EnableLDAPS en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSRadius.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita la autenticación multifactor (MFA) con la configuración del servidor RADIUS proporcionada para un Conector AD o directorio de 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 obtener información sobre la API, consulte EnableRadius en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSSso.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se habilita el inicio de sesión único en un directorio.

Enable-DSSso -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte EnableSso en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSCertificate.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestra información sobre el certificado registrado para una conexión LDAP segura.

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

Salida:

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 obtener información sobre la API, consulte DescribeCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSCertificateList.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestran todos los certificados registrados para una conexión LDAP segura para el directorio especificado.

Get-DSCertificateList -DirectoryId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte ListCertificates en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSConditionalForwarder.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtienen todos los reenviadores condicionales configurados con un Directory-id determinado.

Get-DSConditionalForwarder -DirectoryId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte DescribeConditionalForwarders en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDirectory.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtiene información acerca de los directorios que pertenecen a esta cuenta.

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

Salida:

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 obtener información sobre la API, consulte DescribeDirectories en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDirectoryLimit.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestra información acerca de los límites del directorio para la región us-east-1.

Get-DSDirectoryLimit -Region us-east-1

Salida:

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

  • Para obtener información sobre la API, consulte GetDirectoryLimits en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDomainControllerList.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtiene la lista detallada de los controladores de dominio lanzados para el directory-id especificado.

Get-DSDomainControllerList -DirectoryId d-123456ijkl

Salida:

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 obtener información sobre la API, consulte DescribeDomainControllers en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSEventTopic.

Herramientas para PowerShell V4

Ejemplo 1: Este comando muestra información sobre el tema de SNS configurado para su notificación cuando el estado del directorio cambie.

Get-DSEventTopic -DirectoryId d-123456ijkl

Salida:

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 obtener información sobre la API, consulte DescribeEventTopics en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSIpRouteList.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtienen los bloques de direcciones IP públicas configurados en el enrutamiento IP de directorios.

Get-DSIpRouteList -DirectoryId d-123456ijkl

Salida:

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 obtener información sobre la API, consulte ListIpRoutes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSLDAPSSetting.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se describe el estado de la seguridad LDAP para el directorio especificado.

Get-DSLDAPSSetting -DirectoryId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte DescribeLDAPSSettings en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSLogSubscriptionList.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtiene información acerca de las suscripciones de registro del directory-id especificado.

Get-DSLogSubscriptionList -DirectoryId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte ListLogSubscriptions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtienen todas las etiquetas del directorio especificado.

Get-DSResourceTag -ResourceId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte ListTagsForResource en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSchemaExtension.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se muestran todas las extensiones de esquema que se aplican a un directorio de Microsoft AD.

Get-DSSchemaExtension -DirectoryId d-123456ijkl

Salida:

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 obtener información sobre la API, consulte ListSchemaExtensions en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSharedDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se obtienen los directorios compartidos de su cuenta de AWS.

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

Salida:

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 obtener información sobre la API, consulte DescribeSharedDirectories en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSnapshot.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtiene información acerca de las instantáneas de directorio especificadas que pertenecen a esta cuenta.

Get-DSSnapshot -DirectoryId d-123456ijkl

Salida:

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 obtener información sobre la API, consulte DescribeSnapshots en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSnapshotLimit.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtienen los límites de instantáneas manuales de un directorio especificado.

Get-DSSnapshotLimit -DirectoryId d-123456ijkl

Salida:

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

  • Para obtener información sobre la API, consulte GetSnapshotLimits en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSTrust.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se obtiene información acerca de las relaciones de confianza creadas para el directory-id especificado.

Get-DSTrust -DirectoryId d-123456abcd

Salida:

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 obtener información sobre la API, consulte DescribeTrusts en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSAlias.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se crea un alias para un directorio y se asigna al directory-id especificado.

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

Salida:

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

  • Para obtener información sobre la API, consulte CreateAlias en la Referencia de Cmdlet de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSComputer.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un nuevo objeto de equipo de Active Directory.

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

Salida:

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

  • Para obtener información sobre la API, consulte CreateComputer en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSConditionalForwarder.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un reenviador condicional en el Directory-id de AWS especificado.

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

  • Para obtener información sobre la API, consulte CreateConditionalForwarder en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un nuevo directorio de Simple AD.

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

  • Para obtener información sobre la API, consulte CreateDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSLogSubscription.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una suscripción para reenviar registros de seguridad del controlador de dominio de Directory Service en tiempo real al grupo de registros de Amazon CloudWatch especificado en su Cuenta de AWS.

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

  • Para obtener información sobre la API, consulte CreateLogSubscription en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSMicrosoftAD.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea un nuevo directorio de Microsoft AD en Nube de AWS.

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

  • Para obtener información sobre la API, consulte CreateMicrosoftAD en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSSnapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una instantánea del directorio.

New-DSSnapshot -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte CreateSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-DSTrust.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se crea una relación de confianza bidireccional en todo el bosque entre el directorio de Microsoft AD administrado por AWS y el directorio de Microsoft Active Directory existente en las instalaciones.

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

Salida:

t-9067157123

  • Para obtener información sobre la API, consulte CreateTrust en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-DSCertificate.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se registra un certificado para una conexión LDAP segura.

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

Salida:

c-906731e350

  • Para obtener información sobre la API, consulte RegisterCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Register-DSEventTopic.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se asocia un directorio como publicador a un tema de SNS.

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

  • Para obtener información sobre la API, consulte RegisterEventTopic en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSConditionalForwarder.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el reenviador condicional que se ha configurado para su directorio de AWS.

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

  • Para obtener información sobre la API, consulte DeleteConditionalForwarder en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSDirectory.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina un directorio de AWS Directory Service (Simple AD, Microsoft AD o Conector AD).

Remove-DSDirectory -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte DeleteDirectory en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSIpRoute.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se elimina la IP especificada de las rutas IP configuradas de Directory-id.

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

  • Para obtener información sobre la API, consulte RemoveIpRoutes en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSLogSubscription.

Herramientas para PowerShell V4

Ejemplo 1: Con este comando se elimina la suscripción de registro del Directory-id especificado.

Remove-DSLogSubscription -DirectoryId d-123456ijkl

  • Para obtener información sobre la API, consulte DeleteLogSubscription en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSResourceTag.

Herramientas para PowerShell V4

Ejemplo 1: Este comando elimina la etiqueta de recurso asignada al Directory-id especificado.

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

  • Para obtener información sobre la API, consulte RemoveTagsFromResource en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSSnapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la instantánea creada manualmente.

Remove-DSSnapshot -SnapshotId s-9068b488kc

  • Para obtener información sobre la API, consulte DeleteSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSTrust.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina la relación de confianza existente entre el directorio de AD administrado por AWS y un dominio externo.

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

Salida:

t-9067157123

  • Para obtener información sobre la API, consulte DeleteTrust en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Reset-DSUserPassword.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restablece la contraseña de un usuario de Active Directory llamado ADUser en el directorio de Microsoft AD o Simple AD administrado por AWS.

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

  • Para obtener información sobre la API, consulte ResetUserPassword en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Restore-DSFromSnapshot.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se restaura un directorio mediante una instantánea de directorio existente.

Restore-DSFromSnapshot -SnapshotId s-9068b488kc

  • Para obtener información sobre la API, consulte RestoreFromSnapshot en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Set-DSDomainControllerCount.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se establece el número de controladores de dominio en 3 para el directory-id especificado.

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

  • Para obtener información sobre la API, consulte UpdateNumberOfDomainControllers en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Start-DSSchemaExtension.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se aplica una extensión de esquema a un directorio de Microsoft AD.

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

Salida:

e-9067306643

  • Para obtener información sobre la API, consulte StartSchemaExtension en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Stop-DSSchemaExtension.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se cancela una extensión de esquema en curso a un directorio de Microsoft AD.

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

  • Para obtener información sobre la API, consulte CancelSchemaExtension en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-DSCertificate.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina del sistema el certificado registrado para una conexión LDAP segura.

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

  • Para obtener información sobre la API, consulte DeregisterCertificate en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-DSEventTopic.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se elimina el directorio especificado como publicador en el tema de SNS especificado.

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

  • Para obtener información sobre la API, consulte DeregisterEventTopic en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSConditionalForwarder.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza un reenviador condicional que se ha configurado para su directorio de AWS.

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

  • Para obtener información sobre la API, consulte UpdateConditionalForwarder en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSRadius.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza la información acerca del servidor RADIUS para un Conector AD o directorio de Microsoft AD.

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

  • Para obtener información sobre la API, consulte UpdateRadius en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSTrust.

Herramientas para PowerShell V4

Ejemplo 1: En este ejemplo se actualiza el parámetro SelectiveAuth del trust-id especificado de Deshabilitado a Habilitado.

Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled

Salida:

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

  • Para obtener información sobre la API, consulte UpdateTrust en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).