

Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh [SDK AWS Doc](https://github.com/awsdocs/aws-doc-sdk-examples). GitHub 

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh ACM menggunakan Alat untuk V4 PowerShell
<a name="powershell_4_acm_code_examples"></a>

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan Alat AWS untuk PowerShell V4 dengan ACM.

*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

**Topics**
+ [Tindakan](#actions)

## Tindakan
<a name="actions"></a>

### `Get-ACMCertificate`
<a name="acm_GetCertificate_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`Get-ACMCertificate`.

**Alat untuk PowerShell V4**  
**Contoh 1: Contoh ini menunjukkan cara mengembalikan sertifikat dan rantainya menggunakan ARN sertifikat.**  

```
Get-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+  Untuk detail API, lihat [GetCertificate](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 

### `Get-ACMCertificateDetail`
<a name="acm_DescribeCertificate_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`Get-ACMCertificateDetail`.

**Alat untuk PowerShell V4**  
**Contoh 1: Mengembalikan rincian sertifikat yang ditentukan.**  

```
Get-ACMCertificateDetail -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
**Output:**  

```
CertificateArn          : arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
CreatedAt               : 1/21/2016 5:55:59 PM
DomainName              : www.example.com
DomainValidationOptions : {www.example.com}
InUseBy                 : {}
IssuedAt                : 1/1/0001 12:00:00 AM
Issuer                  :
KeyAlgorithm            : RSA-2048
NotAfter                : 1/1/0001 12:00:00 AM
NotBefore               : 1/1/0001 12:00:00 AM
RevocationReason        :
RevokedAt               : 1/1/0001 12:00:00 AM
Serial                  :
SignatureAlgorithm      : SHA256WITHRSA
Status                  : PENDING_VALIDATION
Subject                 : CN=www.example.com
SubjectAlternativeNames : {www.example.net}
```
+  Untuk detail API, lihat [DescribeCertificate](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 

### `Get-ACMCertificateList`
<a name="acm_ListCertificates_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`Get-ACMCertificateList`.

**Alat untuk PowerShell V4**  
**Contoh 1: Mengambil daftar semua sertifikat Anda ARNs dan nama domain untuk masing-masing. Cmdlet akan secara otomatis melakukan paginasi untuk mengambil semua file. ARNs Untuk mengontrol pagination secara manual, gunakan MaxItem parameter - untuk mengontrol berapa banyak sertifikat ARNs yang dikembalikan untuk setiap panggilan layanan dan NextToken parameter - untuk menunjukkan titik awal untuk setiap panggilan.**  

```
Get-ACMCertificateList
```
**Output:**  

```
CertificateArn                                                                      DomainName
--------------                                                                      ----------
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012 www.example.com
```
**Contoh 2: Mengambil daftar semua sertifikat Anda ARNs di mana status sertifikat cocok pada status yang disediakan.**  

```
Get-ACMCertificateList -CertificateStatus "VALIDATION_TIMED_OUT","FAILED"
```
**Contoh 3: Contoh ini mengembalikan daftar semua sertifikat di wilayah us-east-1 yang memiliki tipe kunci RSA\$12048, dan penggunaan kunci yang diperluas, atau tujuan, dari CODE\$1SIGNING. Anda dapat menemukan nilai untuk parameter pemfilteran ini di topik referensi ListCertificates Filter API: https://docs.aws.amazon.com/acm/ latest/APIReference/API \$1Filters.html.**  

```
Get-ACMCertificateList -Region us-east-1 -Includes_KeyType RSA_2048 -Includes_ExtendedKeyUsage CODE_SIGNING
```
**Output:**  

```
CertificateArn                                                                      DomainName                
--------------                                                                      ----------                
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-d7c0-48c1-af8d-2133d8f30zzz *.route53docs.com
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-98a5-443d-a734-800430c80zzz nerdzizm.net               
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-2be6-4376-8fa7-bad559525zzz                           
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-e7ca-44c5-803e-24d9f2f36zzz                           
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-1241-4b71-80b1-090305a62zzz                           
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-8709-4568-8c64-f94617c99zzz                           
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-a8fa-4a61-98cf-e08ccc0eezzz                           
arn:aws:acm:us-east-1:8xxxxxxxxxxx:certificate/xxxxxxxx-fa47-40fe-a714-2d277d3eezzz *.route53docs.com
```
+  Untuk detail API, lihat [ListCertificates](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 

### `New-ACMCertificate`
<a name="acm_RequestCertificate_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`New-ACMCertificate`.

**Alat untuk PowerShell V4**  
**Contoh 1: Membuat sertifikat baru. Layanan mengembalikan ARN sertifikat baru.**  

```
New-ACMCertificate -DomainName "www.example.com"
```
**Output:**  

```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
**Contoh 2: Membuat sertifikat baru. Layanan mengembalikan ARN sertifikat baru.**  

```
New-ACMCertificate -DomainName "www.example.com" -SubjectAlternativeName "example.com","www.example.net"
```
**Output:**  

```
arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012
```
+  Untuk detail API, lihat [RequestCertificate](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 

### `Remove-ACMCertificate`
<a name="acm_DeleteCertificate_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`Remove-ACMCertificate`.

**Alat untuk PowerShell V4**  
**Contoh 1: Menghapus sertifikat yang diidentifikasi oleh ARN yang disediakan dan kunci pribadi terkait. Cmdlet akan meminta konfirmasi sebelum melanjutkan; tambahkan sakelar -Force untuk menekan konfirmasi.**  

```
Remove-ACMCertificate -CertificateArn "arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
```
+  Untuk detail API, lihat [DeleteCertificate](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 

### `Send-ACMValidationEmail`
<a name="acm_ResendValidationEmail_powershell_4_topic"></a>

Contoh kode berikut menunjukkan cara menggunakan`Send-ACMValidationEmail`.

**Alat untuk PowerShell V4**  
**Contoh 1: Permintaan agar email untuk memvalidasi kepemilikan domain untuk 'www.example.com' dikirim. Jika \$1 shell Anda ConfirmPreference disetel ke 'Medium' atau lebih rendah, cmdlet akan meminta konfirmasi sebelum memproses. Tambahkan sakelar -Force untuk menekan permintaan konfirmasi.**  

```
$params = @{
    CertificateArn="arn:aws:acm:us-east-1:123456789012:certificate/12345678-1234-1234-1234-123456789012"
    Domain="www.example.com"
    ValidationDomain="example.com"    
}        
Send-ACMValidationEmail @params
```
+  Untuk detail API, lihat [ResendValidationEmail](https://docs.aws.amazon.com/powershell/v4/reference)di *Referensi Alat AWS untuk PowerShell Cmdlet (V4)*. 