Directory Service ejemplos de uso de Tools for V5 PowerShell - Herramientas de AWS para PowerShell (versión 5)
Acciones

¡Se Herramientas de AWS para PowerShell ha lanzado la versión 5 (V5) del!

Para obtener información sobre los cambios más importantes y la migración de sus aplicaciones, consulte el tema sobre migración.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Directory Service ejemplos de uso de Tools for V5 PowerShell

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V5 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 la PowerShell V5

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 más información sobre la API, consulte AddIpRoutesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte AddTagsToResourcela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

Approve-DSTrust -TrustId t-9067157123

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se acepta una solicitud de compartición de directorios enviada por el propietario Cuenta de AWS 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

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ConnectDirectoryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte RejectSharedDirectoryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte UnshareDirectoryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se desactivan las llamadas seguras LDAP 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 (V5).

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

Herramientas para V5 PowerShell

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 más información sobre la API, consulte DisableRadiusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

Disable-DSSso -DirectoryId d-123456ijkl

  • Para obtener más información sobre la API, consulte DisableSsola referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este ejemplo comparte un directorio específico de su AWS cuenta con otra AWS cuenta mediante el método Handshake.

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

Salida:

d-9067012345

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se activa el modificador para que el directorio específico 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 (V5).

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

Herramientas para V5 PowerShell

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 más información sobre la API, consulte EnableRadiusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

Enable-DSSso -DirectoryId d-123456ijkl

  • Para obtener más información sobre la API, consulte EnableSsola referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeCertificatela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ListCertificatesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeConditionalForwardersla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeDirectoriesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte GetDirectoryLimitsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeDomainControllersla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeEventTopicsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ListIpRoutesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 detallada sobre la API, consulte la sección Describe LDAPSSettings in Herramientas de AWS para PowerShell Cmdlet Reference (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ListLogSubscriptionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ListTagsForResourcela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte ListSchemaExtensionsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se obtienen los directorios compartidos de su cuenta 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

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeSnapshotsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte GetSnapshotLimitsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DescribeTrustsla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte CreateAliasla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte CreateComputerla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este ejemplo crea un reenviador condicional en el ID de directorio especificado AWS .

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

  • Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet CreateConditionalForwarderReference (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte CreateDirectoryla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este ejemplo crea una suscripción para reenviar los 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

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte CreateMicrosoftAD en Herramientas de AWS para PowerShell Cmdlet Reference (V5).

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

Herramientas para la versión 5 PowerShell

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

New-DSSnapshot -DirectoryId d-123456ijkl

  • Para obtener más información sobre la API, consulte CreateSnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: Este ejemplo crea una confianza bidireccional en todo el bosque entre el directorio administrado de AWS Microsoft AD y el 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

Salida:

t-9067157123

  • Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet CreateTrustReference (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte RegisterCertificatela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte RegisterEventTopicla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

  • Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DeleteConditionalForwarderReference (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: En este ejemplo se elimina un AWS directorio de servicios de directorio (conector AD/Microsoft AD/AD simple)

Remove-DSDirectory -DirectoryId d-123456ijkl

  • Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DeleteDirectoryReference (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte RemoveIpRoutesla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

Remove-DSLogSubscription -DirectoryId d-123456ijkl

  • Para obtener más información sobre la API, consulte DeleteLogSubscriptionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

  • Para obtener más información sobre la API, consulte RemoveTagsFromResourcela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

Remove-DSSnapshot -SnapshotId s-9068b488kc

  • Para obtener más información sobre la API, consulte DeleteSnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

Salida:

t-9067157123

  • Para obtener más información sobre la API, consulte DeleteTrustla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

  • Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet ResetUserPasswordReference (V5).

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

Herramientas para la versión 5 PowerShell

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

Restore-DSFromSnapshot -SnapshotId s-9068b488kc

  • Para obtener más información sobre la API, consulte RestoreFromSnapshotla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte StartSchemaExtensionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte CancelSchemaExtensionla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DeregisterCertificatela referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte DeregisterEventTopicla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

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

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

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

Herramientas para la versión 5 PowerShell

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 más información sobre la API, consulte UpdateRadiusla referencia de Herramientas de AWS para PowerShell cmdlets (V5).

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

Herramientas para la versión 5 PowerShell

Ejemplo 1: en este ejemplo se actualiza el SelectiveAuth parámetro del identificador de confianza especificado de desactivado a activado.

Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled

Salida:

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