Directory Service esempi di utilizzo di Tools for V5 PowerShell

Esempio 1: questo comando rimuove il tag di risorsa assegnato all’ID directory specificato

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

Esempio 1: questo comando aggiunge il tag di risorsa all’ID di directory specificato

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

Esempio 1: questo esempio chiama l'operazione dell' VerifyTrust API AWS Directory Service per il Trustid specificato.

Approve-DSTrust -TrustId t-9067157123

Esempio 1: Questo esempio accetta una richiesta di condivisione della directory inviata dal proprietario Account AWS della directory.

Confirm-DSSharedDirectory -SharedDirectoryId d-9067012345

Output:

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

Esempio 1: questo esempio crea un AD Connector per la connessione a una directory on-premises.

Connect-DSDirectory -Name contoso.com -ConnectSettings_CustomerUserName Administrator -Password $Password -ConnectSettings_CustomerDnsIp 172.31.36.96 -ShortName CONTOSO -Size Small -ConnectSettings_VpcId vpc-123459da -ConnectSettings_SubnetId subnet-1234ccaa, subnet-5678ffbb

Esempio 1: questo esempio rifiuta una richiesta di condivisione della directory inviata dall’account del proprietario della directory.

Deny-DSSharedDirectory -SharedDirectoryId d-9067012345

Output:

d-9067012345

Esempio 1: questo esempio arresta la condivisione della directory tra il proprietario della directory e gli account consumer.

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

Output:

d-9067012345

Esempio 1: questo esempio disattiva le chiamate LDAP protette per la directory specificata.

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

Esempio 1: questo esempio disabilita il server RADIUS configurato per una directory AD Connector o Microsoft AD.

Disable-DSRadius -DirectoryId d-123456ijkl

Esempio 1: questo esempio disabilita l’autenticazione Single Sign-On (SSO) per una directory.

Disable-DSSso -DirectoryId d-123456ijkl

Esempio 1: Questo esempio condivide una directory specificata nel tuo AWS account con un altro AWS account utilizzando il metodo Handshake.

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

Output:

d-9067012345

Esempio 1: questo esempio attiva l’opzione per la directory specifica in modo da utilizzare sempre le chiamate LDAP protette.

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

Esempio 1: questo esempio abilita l’autenticazione a più fattori (MFA) con la configurazione server RADIUS fornita per una directory 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

Esempio 1: questo esempio abilita l’autenticazione Single Sign-On (SSO) per una directory.

Enable-DSSso -DirectoryId d-123456ijkl

Esempio 1: questo esempio visualizza informazioni sul certificato registrato per una connessione LDAP protetta.

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

Output:

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.

Esempio 1: questo esempio elenca tutti i certificati registrati per una connessione LDAP protetta per la directory specificata.

Get-DSCertificateList -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando ottiene tutti i server d’inoltro condizionale per l’ID directory specificato.

Get-DSConditionalForwarder -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando restituisce le informazioni sulle directory appartenenti a questo account.

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

Output:

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

Esempio 1: questo esempio visualizza le informazioni sui limiti delle directory per la Regione us-east-1.

Get-DSDirectoryLimit -Region us-east-1

Output:

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

Esempio 1: questo comando ottiene l’elenco dettagliato dei controller di dominio avviati per l’ID directory specificato

Get-DSDomainControllerList -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando visualizza le informazioni relative all’argomento SNS configurato per la notifica quando lo stato della directory cambia.

Get-DSEventTopic -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando ottiene i blocchi di indirizzi IP pubblici configurati nel routing di IP delle directory

Get-DSIpRouteList -DirectoryId d-123456ijkl

Output:

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 :

Esempio 1: questo esempio descrive lo stato della sicurezza LDAP per la directory specificata.

Get-DSLDAPSSetting -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando ottiene le informazioni sugli abbonamenti ai log per l’ID directory specificato

Get-DSLogSubscriptionList -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando ottiene tutti i tag della directory specificata.

Get-DSResourceTag -ResourceId d-123456ijkl

Output:

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

Esempio 1: questo esempio elenca tutte le estensioni dello schema applicate a una directory Microsoft AD.

Get-DSSchemaExtension -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo esempio ottiene le directory condivise del tuo account AWS

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

Output:

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

Esempio 1: questo comando restituisce le informazioni sugli snapshot di directory specificati appartenenti a questo account.

Get-DSSnapshot -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando restituisce i limiti degli snapshot manuali per una directory specificata.

Get-DSSnapshotLimit -DirectoryId d-123456ijkl

Output:

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

Esempio 1: questo comando restituisce le informazioni sulle relazioni di attendibilità create per l’ID directory specificato.

Get-DSTrust -DirectoryId d-123456abcd

Output:

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

Esempio 1: questo comando crea un alias per una directory e assegna tale alias all’ID directory specificato.

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

Output:

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

Esempio 1: questo esempio crea un nuovo oggetto computer Active Directory.

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

Output:

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

Esempio 1: Questo esempio crea un server d'inoltro condizionale nell'ID di directory specificato. AWS

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

Esempio 1: questo esempio crea una nuova directory Simple AD.

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

Esempio 1: questo esempio crea un abbonamento per inoltrare in tempo reale i log di sicurezza dei controller di dominio Directory Service al gruppo di CloudWatch log Amazon specificato nel tuo Account AWS.

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

Esempio 1: Questo esempio crea una nuova directory Microsoft AD in Cloud AWS.

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

Esempio 1: questo esempio crea uno snapshot di directory

New-DSSnapshot -DirectoryId d-123456ijkl

Esempio 1: questo esempio crea un trust bidirezionale a livello di foresta tra la directory AWS Managed Microsoft AD e Microsoft Active Directory esistente in locale.

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

Output:

t-9067157123

Esempio 1: questo esempio registra un certificato per la connessione LDAP protetta.

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

Output:

c-906731e350

Esempio 1: questo esempio associa una directory come publisher a un argomento SNS.

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

Esempio 1: Questo esempio rimuove il server d'inoltro condizionale che è stato impostato per Direcotry. AWS

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

Esempio 1: Questo esempio elimina una AWS directory del servizio Directory (Simple AD/Microsoft AD/AD Connector)

Remove-DSDirectory -DirectoryId d-123456ijkl

Esempio 1: questo comando rimuove l’IP specificato dalle route IP configurate di Directory-id.

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

Esempio 1: questo comando rimuove l’abbonamento ai log per l’ID directory specificato

Remove-DSLogSubscription -DirectoryId d-123456ijkl

Esempio 1: questo comando rimuove il tag di risorsa assegnato all’ID directory specificato

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

Esempio 1: questo esempio rimuove lo snapshot creato manualmente.

Remove-DSSnapshot -SnapshotId s-9068b488kc

Esempio 1: questo esempio rimuove la relazione di trust esistente tra la directory AD AWS gestita e un dominio esterno.

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

Output:

t-9067157123

Esempio 1: Questo esempio reimposta la password dell'utente di Active Directory denominato ADUser in AWS Managed microsoft AD o Simple AD Directory

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

Esempio 1: questo esempio ripristina una directory utilizzando uno snapshot della directory esistente.

Restore-DSFromSnapshot -SnapshotId s-9068b488kc

Esempio 1: questo esempio imposta il numero di controller di dominio su 3 per l’ID directory specificato.

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

Esempio 1: questo esempio elenca un’estensione dello schema a una directory Microsoft AD.

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

Output:

e-9067306643

Esempio 1: questo esempio annulla un’estensione dello schema in esecuzione su una directory Microsoft AD.

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

Esempio 1: questo esempio elimina dal sistema il certificato registrato per una connessione LDAP protetta.

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

Esempio 1: questo esempio rimuove la directory specificata come publisher per l’argomento SNS specificato.

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

Esempio 1: Questo esempio aggiorna un server d'inoltro condizionale che è stato impostato per la directory. AWS

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

Esempio 1: questo esempio aggiorna le informazioni del server RADIUS per una directory AD Connector o Microsoft AD.

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

Esempio 1: Questo esempio aggiorna il SelectiveAuth parametro del trust-id specificato da Disabled a Enabled.

Update-DSTrust -TrustId t-9067157123 -SelectiveAuth Enabled

Output:

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