Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de ejemplos de AWS Doc SDK
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.
AWS Directory Service ejemplos de uso de Tools for V4 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 V4 con AWS 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.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar Add-DSIpRoute
.
- Herramientas para la PowerShell V4
-
Ejemplo 1: Este comando elimina la etiqueta de recurso asignada al ID de directorio 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 AddIpRoutes Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Add-DSResourceTag
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando añade la etiqueta de recurso al identificador de directorio especificado
Add-DSResourceTag -ResourceId d-123456ijkl -Tag @{Key="myTag"; Value="mytgValue"}
-
Para obtener más información sobre la API, consulte AddTagsToResource Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Approve-DSTrust
.
- Herramientas para la versión 4 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
-
Para obtener más información sobre la API, consulte VerifyTrust Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Confirm-DSSharedDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo acepta una solicitud de uso compartido de directorios enviada por el propietario del directorio Cuenta de AWS.
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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Connect-DSDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se crea un AD Connector para conectarse a un directorio local.
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 (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Deny-DSSharedDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se rechaza una solicitud de uso compartido de directorios enviada 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 RejectSharedDirectory Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSDirectoryShare
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo detiene el uso compartido de directorios 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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSLDAPS
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo desactiva las llamadas seguras de LDAP para el directorio especificado.
Disable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
-
Para obtener información sobre la API, consulte DisableLDAPS en Cmdlet Reference (V4).Herramientas de AWS para PowerShell
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSRadius
.
- PowerShell Herramientas para la versión 4
-
Ejemplo 1: Este ejemplo deshabilita el servidor RADIUS configurado para un directorio AD Connector o Microsoft AD.
Disable-DSRadius -DirectoryId d-123456ijkl
-
Para obtener más información sobre la API, consulte DisableRadius Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Disable-DSSso
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se inhabilita el inicio de sesión único en un directorio.
Disable-DSSso -DirectoryId d-123456ijkl
-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DisableSsoReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSDirectoryShare
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se comparte un directorio específico de tu 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
-
Para obtener más información sobre la API, consulte ShareDirectory Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSLDAPS
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo activa el conmutador para que el directorio específico utilice siempre las llamadas seguras de LDAP.
Enable-DSLDAPS -DirectoryId d-123456ijkl -Type Client
-
Para obtener información sobre la API, consulte EnableLDAPS en Herramientas de AWS para PowerShell Cmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSRadius
.
- PowerShell Herramientas para la versión 4
-
Ejemplo 1: Este ejemplo habilita la autenticación multifactor (MFA) con la configuración de servidor RADIUS proporcionada para un directorio AD Connector o 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 EnableRadius Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Enable-DSSso
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo 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 EnableSso Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSCertificate
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo 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 DescribeCertificate Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSCertificateList
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se enumeran 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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSConditionalForwarder
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene todos los reenviadores condicionales configurados para un identificador de directorio 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 Herramientas de AWS para PowerShell Cmdlet DescribeConditionalForwardersReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene información sobre 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 DescribeDirectories Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDirectoryLimit
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se muestra la información del límite de directorios 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 Herramientas de AWS para PowerShell Cmdlet GetDirectoryLimitsReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSDomainControllerList
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene la lista detallada de los controladores de dominio lanzados para el identificador de directorio mencionado
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 DescribeDomainControllers Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSEventTopic
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando muestra información sobre el tema de SNS configurado para notificarlo 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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSIpRouteList
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene los bloques de direcciones IP públicas configurados en el enrutamiento IP de directorio
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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSLDAPSSetting
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se describe el estado de la seguridad de 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 más información sobre la API, consulte Describe LDAPSSettings in Herramientas de AWS para PowerShell Cmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSLogSubscriptionList
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene la información de registro de suscripciones del identificador de directorio 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 ListLogSubscriptions Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSResourceTag
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene 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 ListTagsForResource Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSchemaExtension
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se enumeran todas las extensiones de esquema aplicadas 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 ListSchemaExtensions Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSharedDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se obtienen los directorios compartidos de su AWS cuenta
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 Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSnapshot
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene información sobre 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 DescribeSnapshots Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSSnapshotLimit
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene los límites de instantáneas manuales para un directorio específico.
Get-DSSnapshotLimit -DirectoryId d-123456ijkl
Salida:
ManualSnapshotsCurrentCount ManualSnapshotsLimit ManualSnapshotsLimitReached --------------------------- -------------------- --------------------------- 0 5 False
-
Para obtener más información sobre la API, consulte GetSnapshotLimits Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Get-DSTrust
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando obtiene la información de las relaciones de confianza creadas para el identificador de directorio 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 DescribeTrusts Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSAlias
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando crea un alias para un directorio y lo asigna al identificador de directorio 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 del Herramientas de AWS para PowerShell cmdlet (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSComputer
.
- Herramientas para la versión 4 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 CreateComputer Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSConditionalForwarder
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo crea un reenviador condicional en el ID de AWS directorio especificado.
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 (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se crea un nuevo directorio 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 CreateDirectory Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSLogSubscription
.
- Herramientas para la versión 4 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
-
Para obtener más información sobre la API, consulte CreateLogSubscription Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSMicrosoftAD
.
- Herramientas para la versión 4 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 (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSSnapshot
.
- Herramientas para la versión 4 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 CreateSnapshot Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar New-DSTrust
.
- Herramientas para la versión 4 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 (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-DSCertificate
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo 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 RegisterCertificate Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Register-DSEventTopic
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se asocia un directorio como editor a un tema de SNS.
Register-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
-
Para obtener información sobre la API, consulte RegisterEventTopic Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSConditionalForwarder
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se elimina el reenviador condicional que se ha configurado para su AWS directorio.
Remove-DSConditionalForwarder -DirectoryId d-123456ijkl -RemoteDomainName contoso.com
-
Para obtener información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DeleteConditionalForwarderReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSDirectory
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: En este ejemplo se elimina un AWS directorio de servicios de directorio (AD/Microsoft AD/ADconector simple)
Remove-DSDirectory -DirectoryId d-123456ijkl
-
Para obtener más información sobre la API, consulte DeleteDirectory Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSIpRoute
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando 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 RemoveIpRoutes Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSLogSubscription
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando elimina la suscripción de registro del identificador de directorio especificado
Remove-DSLogSubscription -DirectoryId d-123456ijkl
-
Para obtener más información sobre la API, consulte DeleteLogSubscription Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSResourceTag
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este comando elimina la etiqueta de recurso asignada al ID de directorio especificado
Remove-DSResourceTag -ResourceId d-123456ijkl -TagKey myTag
-
Para obtener más información sobre la API, consulte RemoveTagsFromResource Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSSnapshot
.
- Herramientas para la versión 4 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 DeleteSnapshot Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Remove-DSTrust
.
- Herramientas para la versión 4 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 información sobre la API, consulte DeleteTrustla referencia de Herramientas de AWS para PowerShell cmdlets (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Reset-DSUserPassword
.
- Herramientas para la versión 4 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 (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Restore-DSFromSnapshot
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo restaura un directorio utilizando una instantánea de directorio existente.
Restore-DSFromSnapshot -SnapshotId s-9068b488kc
-
Para obtener más información sobre la API, consulte RestoreFromSnapshot Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Set-DSDomainControllerCount
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se establece el número de controladores de dominio en 3 para el identificador de directorio especificado.
Set-DSDomainControllerCount -DirectoryId d-123456ijkl -DesiredNumber 3
-
Para obtener más información sobre la API, consulte UpdateNumberOfDomainControllers Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Start-DSSchemaExtension
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo 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 StartSchemaExtension Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Stop-DSSchemaExtension
.
- Herramientas para la versión 4 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 CancelSchemaExtension Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-DSCertificate
.
- Herramientas para la versión 4 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 información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DeregisterCertificateReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Unregister-DSEventTopic
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se elimina el directorio especificado como publicador del tema de SNS especificado.
Unregister-DSEventTopic -DirectoryId d-123456ijkl -TopicName snstopicname
-
Para obtener más información sobre la API, consulte Herramientas de AWS para PowerShell Cmdlet DeregisterEventTopicReference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSConditionalForwarder
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: en este ejemplo se 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
-
Para obtener información sobre la API, consulte UpdateConditionalForwarder Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSRadius
.
- Herramientas para la versión 4 PowerShell
-
Ejemplo 1: Este ejemplo actualiza la información del servidor RADIUS para un directorio AD Connector o Microsoft AD.
Update-DSRadius -DirectoryId d-123456ijkl -RadiusSettings_RadiusRetry 3
-
Para obtener más información sobre la API, consulte UpdateRadius Herramientas de AWS para PowerShellCmdlet Reference (V4).
-
En el siguiente ejemplo de código, se muestra cómo utilizar Update-DSTrust
.
- Herramientas para la versión 4 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
-
Para obtener más información sobre la API, consulte UpdateTrust Herramientas de AWS para PowerShellCmdlet Reference (V4).
-