Share via

about_ActivityCommonParameters

  • Artikel

DESKRIPSI SINGKAT

Menjelaskan parameter yang ditambahkan Alur Kerja Windows PowerShell ke aktivitas.

DESKRIPSI PANJANG

Windows PowerShell Workflow menambahkan parameter umum aktivitas ke aktivitas yang berasal dari kelas dasar PSActivity . Kategori ini mencakup aktivitas InlineScript dan cmdlet Windows PowerShell yang diimplementasikan sebagai aktivitas, seperti Get-Process dan Get-WinEvent.

Parameter umum aktivitas tidak valid pada Suspend-Workflow aktivitas dan Checkpoint-Workflow dan tidak ditambahkan ke cmdlet atau ekspresi yang otomatis dijalankan Alur Kerja Windows PowerShell dalam blok skrip InlineScript atau aktivitas serupa. Parameter umum aktivitas tersedia pada aktivitas InlineScript , tetapi tidak pada perintah di blok skrip InlineScript .

Beberapa parameter umum aktivitas juga merupakan parameter umum alur kerja atau parameter umum Windows PowerShell. Parameter umum aktivitas lainnya unik untuk aktivitas.

Untuk informasi tentang parameter umum alur kerja, lihat about_WorkflowCommonParameters. Untuk informasi tentang parameter umum Windows PowerShell, lihat about_CommonParameters.

DAFTAR PARAMETER UMUM AKTIVITAS

AppendOutput                      PSDebug
Debug                             PSDisableSerialization
DisplayName                       PSDisableSerializationPreference
ErrorAction                       PSError
Input                             PSPersist
MergeErrorToOutput                PSPort
PSActionRetryCount                PSProgress
PSActionRetryIntervalSec          PSProgressMessage
PSActionRunningTimeoutSec         PSRemotingBehavior
PSApplicationName                 PSRequiredModules
PSAuthentication                  PSSessionOption
PSCertificateThumbprint           PSUseSSL
PSComputerName                    PSVerbose
PSConfigurationName               PSWarning
PSConnectionRetryCount            Result
PSConnectionRetryIntervalSec      UseDefaultInput
PSConnectionURI                   Verbose
PSCredential                      WarningAction

DESKRIPSI PARAMETER

Bagian ini menjelaskan parameter umum aktivitas.

AppendOutput <Boolean>

Nilai $True menambahkan output aktivitas ke nilai variabel. Nilai $False tidak berpengaruh. Secara default, menetapkan nilai ke variabel menggantikan nilai variabel.

Misalnya, perintah berikut menambahkan objek proses ke objek layanan dalam $x variabel.

Workflow Test-Workflow
{
    $x = Get-Service
    $x = Get-Process -AppendOutput $true
}

Parameter ini dirancang untuk alur kerja berbasis XAML. Dalam alur kerja skrip, Anda juga dapat menggunakan += operator penugasan untuk menambahkan output ke nilai variabel, seperti yang ditunjukkan dalam contoh berikut.

Workflow Test-Workflow
{
    $x = Get-Service
    $x += Get-Process
}

Debug <SwitchParameter>

Menampilkan detail tingkat programmer tentang operasi yang dilakukan oleh perintah. Parameter Debug mengambil alih nilai $DebugPreference variabel untuk perintah saat ini. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan debugging. Parameter ini juga merupakan parameter umum Windows PowerShell.

String DisplayName <>

Menentukan nama yang mudah diingat untuk aktivitas tersebut. Nilai DisplayName muncul di bilah kemajuan saat alur kerja berjalan dan dalam nilai properti Kemajuan pekerjaan alur kerja. Ketika parameter PSProgressMessage juga disertakan dalam perintah, konten bilah kemajuan muncul dalam <DisplayName>:<PSProgressMessage> format.

ErrorAction <ActionPreference>

Menentukan bagaimana aktivitas merespons kesalahan yang tidak mengakhiri dari perintah. Ini tidak berpengaruh pada kesalahan penghentian. Parameter ini hanya berfungsi ketika perintah menghasilkan kesalahan yang tidak mengakhiri, seperti yang berasal dari Write-Error cmdlet. Parameter ErrorAction mengambil alih nilai $ErrorActionPreference variabel untuk perintah saat ini. Parameter ini juga merupakan parameter umum Windows PowerShell.

Nilai yang valid:

  • Continue. Menampilkan pesan kesalahan dan melanjutkan menjalankan perintah. Continue merupakan nilai defaultnya.

  • Ignore. Menyembunyikan pesan kesalahan dan melanjutkan menjalankan perintah. Tidak seperti SilentlyContinue, Ignore tidak menambahkan pesan kesalahan ke $Error variabel otomatis. Nilai Ignore diperkenalkan di Windows PowerShell 3.0.

  • Inquire. Menampilkan pesan kesalahan dan meminta konfirmasi sebelum melanjutkan eksekusi. Nilai ini jarang digunakan.

  • Suspend. Secara otomatis menangguhkan pekerjaan alur kerja untuk memungkinkan penyelidikan lebih lanjut. Setelah diselidiki, alur kerja dapat dilanjutkan.

  • SilentlyContinue. Menyembunyikan pesan kesalahan dan melanjutkan menjalankan perintah.

  • Stop. Menampilkan pesan kesalahan dan berhenti menjalankan perintah.

Objek Input <[]>

Mengirimkan kumpulan objek ke aktivitas. Ini adalah alternatif untuk piping objek untuk aktivitas satu per satu.

MergeErrorToOutput <Boolean>

Nilai $True menambahkan kesalahan ke aliran output. Nilai $False tidak berpengaruh. Gunakan parameter ini dengan Paralel dan ForEach -Parallel kata kunci untuk mengumpulkan kesalahan dan output dari beberapa perintah paralel dalam satu koleksi.

PSActionRetryCount <Int32>

Mencoba berulang kali untuk menjalankan aktivitas jika upaya pertama gagal. Nilai default, 0, tidak mencoba lagi.

PSActionRetryIntervalSec <Int32>

Menentukan interval antara percobaan ulang tindakan dalam hitungan detik. Nilai default, 0, segera mencoba kembali tindakan. Parameter ini hanya valid ketika parameter PSActionRetryCount juga digunakan dalam perintah .

PSActionRunningTimeoutSec <Int32>

Menentukan berapa lama aktivitas dapat berjalan pada setiap komputer target. Jika aktivitas tidak selesai sebelum batas waktu berakhir, Windows PowerShell Workflow menghasilkan kesalahan penghentian dan berhenti memproses alur kerja pada komputer target yang terpengaruh.

PSAllowRedirection <Boolean>

Nilai memungkinkan $True pengalihan koneksi ke komputer target. Nilai $False tidak berpengaruh. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Saat Anda menggunakan parameter PS Koneksi ionURI, tujuan jarak jauh dapat mengembalikan instruksi untuk mengalihkan ke URI yang berbeda. Secara default, Windows PowerShell tidak mengalihkan koneksi, tetapi Anda dapat menggunakan parameter PSAllowRedirection dengan nilai $True untuk memungkinkan pengalihan koneksi ke komputer target.

Anda juga dapat membatasi berapa kali koneksi dialihkan dengan mengatur properti Maximum Koneksi ionRedirectionCount dari $PSSessionOption variabel preferensi, atau properti Maximum Koneksi ionRedirectionCount dari nilai parameter SessionOption cmdlet yang membuat sesi. Nilai defaultnya adalah 5.

String PSApplicationName <>

Menentukan segmen nama aplikasi dari URI koneksi yang digunakan untuk menyambungkan ke komputer target. Gunakan parameter ini untuk menentukan nama aplikasi saat Anda tidak menggunakan parameter Koneksi ionURI dalam perintah . Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Nilai default adalah nilai $PSSessionApplicationName variabel preferensi pada komputer target. Jika variabel preferensi ini tidak ditentukan, nilai defaultnya adalah WSMAN. Nilai ini sesuai untuk sebagian besar penggunaan. Untuk informasi selengkapnya, lihat about_Preference_Variables.

Layanan WinRM menggunakan nama aplikasi untuk memilih pendengar untuk melayani permintaan koneksi. Nilai parameter ini harus cocok dengan nilai properti URLPrefix pendengar di komputer jarak jauh.

PSAuthentication <AuthenticationMechanism>

Menentukan mekanisme yang digunakan untuk mengautentikasi kredensial pengguna saat menyambungkan ke komputer target. Nilai yang valid adalah Default, Basic, CredSSP, Digest, Kerberos, Negotiate, dan NegotiateWithImplicitCredential. Nilai defaultnya adalah Default. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Untuk informasi tentang nilai parameter ini, lihat deskripsi enumerasi System.Management.Automation.Runspaces.AuthenticationMechanism di PowerShell SDK.

Peringatan

Autentikasi Penyedia Layanan Keamanan Kredensial (CredSSP), di mana kredensial pengguna diteruskan ke komputer jarak jauh untuk diautentikasi, dirancang untuk perintah yang memerlukan autentikasi pada lebih dari satu sumber daya, seperti mengakses berbagi jaringan jarak jauh. Mekanisme ini meningkatkan risiko keamanan operasi jarak jauh. Jika komputer jarak jauh disusupi, kredensial yang diteruskan ke komputer jarak jauh dapat digunakan untuk mengontrol sesi jaringan.

String PSCertificateThumbprint <>

Menentukan sertifikat kunci publik digital (X509) dari akun pengguna yang memiliki izin untuk melakukan tindakan ini. Masukkan thumbprint sertifikat sertifikat. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Sertifikat digunakan dalam autentikasi berbasis sertifikat klien. Mereka hanya dapat dipetakan ke akun pengguna lokal; mereka tidak bekerja dengan akun domain.

Untuk mendapatkan sertifikat, gunakan cmdlet Get-Item atau Get-ChildItem di drive Windows PowerShell Cert: .

String PSComputerName <[]>

Menentukan komputer target tempat aktivitas dijalankan. Defaultnya adalah komputer lokal. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Ketik nama NETBIOS, alamat IP, atau nama domain yang sepenuhnya memenuhi syarat dari satu atau beberapa komputer dalam daftar yang dipisahkan koma. Untuk menentukan komputer lokal, ketik nama komputer, localhost, atau titik (.).

Untuk menyertakan komputer lokal dalam nilai parameter PSComputerName , buka Windows PowerShell dengan opsi Jalankan sebagai administrator .

Jika parameter ini dihilangkan dari perintah, atau nilainya adalah $null atau string kosong, target alur kerja adalah komputer lokal dan jarak jauh Windows PowerShell tidak digunakan untuk menjalankan perintah.

Untuk menggunakan alamat IP dalam nilai parameter ComputerName , perintah harus menyertakan parameter PSCredential . Selain itu, komputer harus dikonfigurasi untuk transportasi HTTPS atau alamat IP komputer jarak jauh harus disertakan dalam daftar WinRM TrustedHosts di komputer lokal. Untuk instruksi menambahkan nama komputer ke daftar TrustedHosts, lihat "Cara Menambahkan Komputer ke Daftar Host Tepercaya" di about_Remote_Troubleshooting.

String PSConfigurationName <>

Menentukan konfigurasi sesi yang digunakan untuk membuat sesi pada komputer target. Masukkan nama konfigurasi sesi pada komputer target (bukan di komputer yang menjalankan alur kerja). Defaultnya adalah Microsoft.PowerShell.Workflow. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

PS Koneksi ionRetryCount <UInt>

Menentukan jumlah maksimum upaya untuk menyambungkan ke setiap komputer target jika upaya koneksi pertama gagal. Masukkan angka antara 1 dan 4.294.967.295 (UInt.MaxValue). Nilai default, nol (0), tidak mewakili upaya coba lagi. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

PS Koneksi ionRetryIntervalSec <UInt>

Menentukan penundaan antara upaya coba lagi koneksi dalam hitungan detik. Nilai defaultnya adalah nol (0). Parameter ini hanya valid ketika nilai PS Koneksi ionRetryCount setidaknya 1. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

PS Koneksi ionURI <System.Uri>

Menentukan Pengidentifikasi Sumber Daya Seragam (URI) yang menentukan titik akhir koneksi untuk aktivitas pada komputer target. URI harus sepenuhnya memenuhi syarat. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Format string ini adalah sebagai berikut:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

Nilai defaultnya adalah http://localhost:5985/WSMAN.

Jika Anda tidak menentukan PS Koneksi ionURI, Anda dapat menggunakan parameter PSUseSSL, PSComputerName, PSPort, dan PSApplicationName untuk menentukan nilai PS Koneksi ionURI.

Nilai yang valid untuk segmen Transportasi URI adalah HTTP dan HTTPS. Jika Anda menentukan URI koneksi dengan segmen Transportasi, tetapi jangan tentukan port, sesi dibuat dengan port standar: 80 untuk HTTP dan 443 untuk HTTPS. Untuk menggunakan port default untuk jarak jauh Windows PowerShell, tentukan port 5985 untuk HTTP atau 5986 untuk HTTPS.

PSCredential <PSCredential>

Menentukan akun pengguna yang memiliki izin untuk menjalankan aktivitas pada komputer target. Defaultnya adalah pengguna saat ini. Parameter ini hanya valid ketika parameter PSComputerName disertakan dalam perintah . Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Ketik nama pengguna, seperti User01 atau Domain01\User01, atau masukkan variabel yang berisi objek PSCredential , seperti Get-Credential yang dikembalikan cmdlet. Jika Anda hanya memasukkan nama pengguna, Anda akan dimintai kata sandi.

PSDebug <PSDataCollection[DebugRecord]>

Menambahkan pesan debug dari aktivitas ke koleksi rekaman debug yang ditentukan, alih-alih menulis pesan debug ke konsol atau ke nilai properti Debug dari pekerjaan alur kerja. Anda dapat menambahkan pesan debug dari beberapa aktivitas ke objek pengumpulan rekaman debug yang sama.

Untuk menggunakan parameter umum aktivitas ini, gunakan New-Object cmdlet untuk membuat objek PSDataCollection dengan jenis DebugRecord dan simpan objek dalam variabel. Kemudian, gunakan variabel sebagai nilai parameter PSDebug dari satu atau beberapa aktivitas, seperti yang ditunjukkan dalam contoh berikut.

Workflow Test-Workflow
{
    $debugCollection = New-Object -Type `
    System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
    InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
    if ($debugCollection -like "Missing") { ...}
}

PSDisableSerialization <Boolean>

Mengarahkan aktivitas untuk mengembalikan objek "langsung" (tidak diserialisasikan) ke alur kerja. Objek yang dihasilkan memiliki metode, serta properti, tetapi tidak dapat disimpan ketika titik pemeriksaan diambil.

PSDisableSerializationPreference <Boolean>

Menerapkan parameter PSDisableSerialization yang setara ke seluruh alur kerja, bukan hanya aktivitas. Menambahkan parameter ini umumnya tidak disarankan, karena alur kerja yang tidak menserialisasikan objeknya tidak dapat dilanjutkan atau dipertahankan.

Nilai yang valid:

  • (Default) Jika dihilangkan, dan Anda juga belum menambahkan parameter PSDisableSerialization ke aktivitas, objek diserialisasikan.

  • $True. Mengarahkan semua aktivitas dalam alur kerja untuk mengembalikan objek "langsung" (tidak diserialisasikan). Objek yang dihasilkan memiliki metode, serta properti, tetapi tidak dapat disimpan ketika titik pemeriksaan diambil.

  • $False. Objek alur kerja diserialisasikan.

PSError <PSDataCollection[ErrorRecord]>

Menambahkan pesan kesalahan dari aktivitas ke kumpulan rekaman kesalahan yang ditentukan, alih-alih menulis pesan kesalahan ke konsol atau ke nilai properti Kesalahan dari pekerjaan alur kerja. Anda dapat menambahkan pesan kesalahan dari beberapa aktivitas ke objek pengumpulan rekaman kesalahan yang sama.

Untuk menggunakan parameter umum aktivitas ini, gunakan New-Object cmdlet untuk membuat objek PSDataCollection dengan jenis ErrorRecord dan simpan objek dalam variabel. Kemudian, gunakan variabel sebagai nilai parameter PSError dari satu atau beberapa aktivitas, seperti yang ditunjukkan dalam contoh berikut.

Workflow Test-Workflow
{
   $typeName = "System.Management.Automation.PSDataCollection"
   $typeName += '[System.Management.Automation.ErrorRecord]'
   $ec = New-Object $typeName
   InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSError $ec
   InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSError $ec
   if ($ec.Count -gt 2)
   {
      # Do Some Work.
   }
}

PSPersist <Boolean>

Mengambil titik pemeriksaan setelah aktivitas. Titik pemeriksaan ini selain titik pemeriksaan apa pun yang ditentukan dalam alur kerja. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

"Titik pemeriksaan" atau "titik persistensi" adalah rekam jepret status alur kerja dan data yang diambil saat alur kerja berjalan dan disimpan ke penyimpanan persistensi pada disk. Windows PowerShell Workflow menggunakan data yang disimpan untuk melanjutkan alur kerja yang ditangguhkan atau terganggu dari titik persistensi terakhir, daripada memulai ulang alur kerja.

Nilai yang valid:

  • (Default) Jika Anda menghilangkan parameter ini, tidak ada titik pemeriksaan yang ditambahkan. Titik pemeriksaan diambil berdasarkan pengaturan untuk alur kerja.

  • $True. Mengambil titik pemeriksaan setelah aktivitas selesai. Titik pemeriksaan ini selain titik pemeriksaan apa pun yang ditentukan dalam alur kerja.

  • $False. Tidak ada titik pemeriksaan yang ditambahkan. Titik pemeriksaan hanya diambil ketika ditentukan dalam alur kerja.

PSPort <Int32>

Menentukan port jaringan pada komputer target. Port default adalah 5985 (port WinRM untuk HTTP) dan 59'86 (port WinRM untuk HTTPS). Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Jangan gunakan parameter PSPort kecuali Anda harus. Port yang diatur dalam perintah berlaku untuk semua komputer atau sesi tempat perintah dijalankan. Pengaturan port alternatif mungkin mencegah perintah berjalan pada semua komputer. Sebelum menggunakan port alternatif, Anda harus mengonfigurasi pendengar WinRM di komputer jarak jauh untuk mendengarkan di port tersebut.

PSProgress <PSDataCollection[ProgressRecord]>

Menambahkan pesan kemajuan dari aktivitas ke kumpulan rekaman kemajuan yang ditentukan, alih-alih menulis pesan kemajuan ke konsol atau ke nilai properti Kemajuan dari pekerjaan alur kerja. Anda dapat menambahkan pesan kemajuan dari beberapa aktivitas ke objek pengumpulan rekaman kemajuan yang sama.

String PSProgressMessage <>

Menentukan deskripsi aktivitas yang ramah. Nilai PSProgressMessage muncul di bilah kemajuan saat alur kerja berjalan. Saat DisplayName juga disertakan dalam perintah, konten bilah kemajuan muncul dalam <DisplayName>:<PSProgressMessage> format.

Parameter ini sangat berguna untuk mengidentifikasi aktivitas dalam ForEach -Parallel blok skrip. Tanpa pesan ini, aktivitas di semua cabang paralel diidentifikasi dengan nama yang sama.

PSRemotingBehavior <RemotingBehavior>

Menentukan bagaimana jarak jauh dikelola ketika aktivitas dijalankan pada komputer target. PowerShell adalah default.

Nilai yang valid adalah:

  • None: Aktivitas tidak dijalankan pada komputer jarak jauh.

  • PowerShell: Jarak jauh Windows PowerShell digunakan untuk menjalankan aktivitas pada komputer target.

  • Custom: Aktivitas ini mendukung jenis jarak jauhnya sendiri. Nilai ini valid ketika cmdlet yang sedang diimplementasikan sebagai aktivitas menetapkan nilai atribut RemotingCapability ke SupportedByCommand dan perintah menyertakan parameter ComputerName .

String PSRequiredModules <[]>

Mengimpor modul yang ditentukan sebelum menjalankan perintah. Masukkan nama modul. Modul harus diinstal pada komputer target.

Modul yang diinstal dalam jalur yang ditentukan dalam variabel lingkungan PSModulePath secara otomatis diimpor pada penggunaan pertama perintah apa pun dalam modul. Gunakan parameter ini untuk mengimpor modul yang tidak berada di lokasi PSModulePath .

Karena setiap aktivitas dalam alur kerja berjalan dalam sesinya sendiri, perintah Import-Module hanya mengimpor modul ke sesi tempatnya berjalan. Ini tidak mengimpor modul ke dalam sesi tempat aktivitas lain berjalan.

PSSessionOption <PSSessionOption>

Mengatur opsi tingkat lanjut untuk sesi ke komputer target. Masukkan objek PSSessionOption, seperti objek yang Anda buat dengan menggunakan New-PSSessionOption cmdlet. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

Nilai default untuk opsi sesi ditentukan oleh nilai $PSSessionOption variabel preferensi, jika diatur. Jika tidak, sesi menggunakan nilai yang ditentukan dalam konfigurasi sesi.

Untuk deskripsi opsi sesi, termasuk nilai default, lihat topik bantuan untuk cmdlet New-PSSessionOption New-PSSessionOption.

Untuk informasi selengkapnya tentang $PSSessionOption variabel preferensi, lihat about_Preference_Variables.

PSUseSSL <Boolean>

Nilai $True menggunakan protokol Secure Sockets Layer (SSL) untuk membuat koneksi ke komputer target. Secara default, SSL tidak digunakan. Nilai $False tidak berpengaruh. Parameter umum aktivitas ini juga merupakan parameter umum alur kerja.

WS-Management mengenkripsi semua konten Windows PowerShell yang dikirimkan melalui jaringan. UseSSL adalah perlindungan tambahan yang mengirim data di seluruh HTTPS, bukan HTTP. Jika Anda menggunakan parameter ini, tetapi SSL tidak tersedia pada port yang digunakan untuk perintah , perintah gagal.

PSVerbose <PSDataCollection[VerboseRecord]>

Menambahkan pesan verbose dari aktivitas ke koleksi rekaman verbose yang ditentukan, alih-alih menulis pesan verbose ke konsol atau ke nilai properti Verbose dari pekerjaan alur kerja. Anda dapat menambahkan pesan verbose dari beberapa aktivitas ke objek pengumpulan rekaman verbose yang sama.

PSWarning <PSDataCollection[WarningRecord]>

Menambahkan pesan peringatan dari aktivitas ke kumpulan rekaman peringatan yang ditentukan, alih-alih menulis pesan peringatan ke konsol atau ke nilai properti Peringatan dari pekerjaan alur kerja. Anda dapat menambahkan pesan peringatan dari beberapa aktivitas ke objek pengumpulan rekaman peringatan yang sama.

Hasil

Parameter ini hanya valid dalam alur kerja XAML.

GunakanDefaultInput <Boolean>

Menerima semua input alur kerja sebagai input ke aktivitas menurut nilai.

Misalnya, Get-Process aktivitas dalam alur kerja sampel berikut menggunakan parameter umum aktivitas UseDefaultInput untuk mendapatkan input yang diteruskan ke alur kerja. Saat Anda menjalankan alur kerja dengan input, input tersebut digunakan oleh aktivitas.

workflow Test-Workflow
{
    Get-Service -UseDefaultInput $True
}

PS C:> Test-Workflow -InputObject WinRm

Status   Name        DisplayName                            PSComputerName
------   ----        -----------                            --------------
Running  winrm       Windows Remote Management (WS-Manag... localhost

Verbose <SwitchParameter>

Menampilkan informasi terperinci tentang operasi yang dilakukan oleh perintah. Informasi ini menyerupan informasi dalam jejak atau dalam log transaksi. Parameter Verbose mengambil alih nilai $VerbosePreference variabel untuk perintah saat ini. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan verbose. Parameter ini juga merupakan parameter umum Windows PowerShell.

WarningAction <ActionPreference>

Menentukan bagaimana aktivitas merespons peringatan. Continue merupakan nilai defaultnya. Parameter WarningAction mengambil alih nilai $WarningPreference variabel untuk perintah saat ini. Parameter ini hanya berfungsi ketika perintah menghasilkan pesan peringatan. Parameter ini juga merupakan parameter umum Windows PowerShell.

Nilai yang Valid:

  • SilentlyContinue. Menekan pesan peringatan dan melanjutkan menjalankan perintah.

  • Continue. Menampilkan pesan peringatan dan melanjutkan menjalankan perintah. Continue merupakan nilai defaultnya.

  • Inquire. Menampilkan pesan peringatan dan meminta konfirmasi sebelum melanjutkan eksekusi. Nilai ini jarang digunakan.

  • Stop. Menampilkan pesan peringatan dan berhenti menjalankan perintah.

Catatan

Parameter WarningAction tidak mengambil alih nilai $WarningAction variabel preferensi saat parameter digunakan dalam perintah untuk menjalankan skrip atau fungsi.

CONTOH

Parameter umum aktivitas sangat berguna. Misalnya, Anda dapat menggunakan parameter PSComputerName untuk menjalankan aktivitas tertentu hanya pada subset komputer target.

Atau, Anda dapat menggunakan parameter PS Koneksi ionRetryCount dan PS Koneksi ionRetryIntervalSec untuk menyesuaikan nilai coba lagi untuk aktivitas tertentu.

Contoh berikut menunjukkan cara menggunakan parameter umum aktivitas PSComputerName untuk menjalankan Get-EventLog aktivitas hanya di komputer, yaitu domain tertentu.

Workflow Test-Workflow
{
    $UserDomain = Get-Content -Path '.\UserComputers.txt'
    $Log = (Get-EventLog -LogName "Windows PowerShell" `
      -PSComputerName $UserDomain)

    if ($Log)
    {
        # Do Work Here.
    }
}

Lihat Juga