about_ActivityCommonParameters
KıSA AÇıKLAMA
Windows PowerShell İş Akışı'nın etkinliklere eklediği parametreleri açıklar.
UZUN AÇıKLAMA
Windows PowerShell İş Akışı, PSActivity temel sınıfından türetilen etkinliklere etkinlik ortak parametrelerini ekler. Bu kategori, Ve gibi Get-Process
etkinlikler olarak uygulanan InlineScript etkinliğini ve Windows PowerShell cmdlet'lerini içerir.Get-WinEvent
Etkinlik ortak parametreleri ve Checkpoint-Workflow
etkinliklerinde Suspend-Workflow
geçerli değildir ve Windows PowerShell İş Akışı'nın bir InlineScript betik bloğunda veya benzer bir etkinlikte otomatik olarak çalıştırdığı cmdlet'lere veya ifadelere eklenmez. Etkinlik ortak parametreleri InlineScript etkinliğinde kullanılabilir, ancak InlineScript betik bloğundaki komutlarda kullanılamaz.
Etkinlik ortak parametrelerinden bazıları iş akışı ortak parametreleri veya Windows PowerShell ortak parametreleridir. Diğer etkinlik ortak parametreleri etkinlikler için benzersizdir.
İş akışı ortak parametreleri hakkında bilgi için bkz . about_WorkflowCommonParameters. Windows PowerShell ortak parametreleri hakkında bilgi için bkz . about_CommonParameters.
ETKINLIK ORTAK PARAMETRELERININ LISTESI
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
PARAMETRE AÇıKLAMALARı
Bu bölümde etkinlik ortak parametreleri açıklanmaktadır.
AppendOutput <Boole değeri>
değeri $True
, etkinliğin çıkışını değişkeninin değerine ekler.
değerinin $False
hiçbir etkisi yoktur. Varsayılan olarak, değişkene değer atamak değişken değerinin yerini alır.
Örneğin, aşağıdaki komutlar değişkendeki $x
hizmet nesnesine bir işlem nesnesi ekler.
Workflow Test-Workflow
{
$x = Get-Service
$x = Get-Process -AppendOutput $true
}
Bu parametre XAML tabanlı iş akışları için tasarlanmıştır. Betik iş akışlarında, aşağıdaki örnekte gösterildiği gibi atama işlecini kullanarak +=
değişkenin değerine çıkış ekleyebilirsiniz.
Workflow Test-Workflow
{
$x = Get-Service
$x += Get-Process
}
SwitchParameter Hatalarını Ayıklama <>
komutu tarafından gerçekleştirilen işlemle ilgili programcı düzeyindeki ayrıntıları görüntüler.
Debug parametresi, geçerli komut için değişkenin $DebugPreference
değerini geçersiz kılar. Bu parametre yalnızca komut hata ayıklama iletileri oluşturduğunda çalışır. Bu parametre aynı zamanda bir Windows PowerShell ortak parametresidir.
DisplayName <Dizesi>
Etkinlik için kolay bir ad belirtir. DisplayName değeri, iş akışı çalışırken ilerleme çubuğunda ve iş akışı işinin Progress özelliğinin değerinde görüntülenir. PSProgressMessage parametresi de komuta eklendiğinde, ilerleme çubuğu içeriği biçimde görünür<DisplayName>:<PSProgressMessage>
.
ErrorAction <ActionPreference>
Etkinliğin komuttan sonlandırıcı olmayan bir hataya nasıl yanıt vereceğini belirler. Sonlandırma hataları üzerinde hiçbir etkisi yoktur. Bu parametre yalnızca komut cmdlet'indekiler gibi sonlandırıcı olmayan bir hata oluşturduğunda Write-Error
çalışır. ErrorAction parametresi, geçerli komut için değişkenin $ErrorActionPreference
değerini geçersiz kılar. Bu parametre aynı zamanda bir Windows PowerShell ortak parametresidir.
Geçerli değerler:
Continue
. Hata iletisini görüntüler ve komutu yürütmeye devam eder.Continue
varsayılan değerdir.Ignore
. Hata iletisini gizler ve komutu yürütmeye devam eder. aksineSilentlyContinue
,Ignore
hata iletisini otomatik değişkene$Error
eklemez. BuIgnore
değer Windows PowerShell 3.0'da kullanıma sunulmuştur.Inquire
. Hata iletisini görüntüler ve yürütmeye devam etmeden önce sizden onay ister. Bu değer nadiren kullanılır.Suspend
. Daha fazla araştırma yapmak için bir iş akışı işini otomatik olarak askıya alır. Araştırmadan sonra iş akışı sürdürülebilir.SilentlyContinue
. Hata iletisini gizler ve komutu yürütmeye devam eder.Stop
. Hata iletisini görüntüler ve komutu yürütmeyi durdurur.
Giriş <Nesnesi[]>
Bir etkinliğe nesne koleksiyonu gönderir. Bu, nesneleri her seferinde bir etkinliğe borulamanın alternatifidir.
MergeErrorToOutput <Boole değeri>
değeri $True
çıkış akışına hata ekler. değerinin $False
hiçbir etkisi yoktur. Tek bir koleksiyondaki birden çok paralel komuttan hata ve çıkış toplamak için Bu parametreyi Parallel ve ForEach -Parallel
anahtar sözcüklerle kullanın.
PSActionRetryCount <Int32>
İlk deneme başarısız olursa etkinliği tekrar tekrar çalıştırmayı dener. Varsayılan değer olan , 0
yeniden denemez.
PSActionRetryIntervalSec <Int32>
Eylem yeniden denemeleri arasındaki aralığı saniye cinsinden belirler. Varsayılan değer olan 0
, eylemi hemen yeniden denenir. Bu parametre yalnızca komutta PSActionRetryCount parametresi de kullanıldığında geçerlidir.
PSActionRunningTimeoutSec <Int32>
Etkinliğin her hedef bilgisayarda ne kadar süreyle çalışabileceğini belirler. Zaman aşımı süresi dolmadan etkinlik tamamlanmazsa, Windows PowerShell İş Akışı sonlandırıcı bir hata oluşturur ve etkilenen hedef bilgisayarda iş akışını işlemeyi durdurur.
PSAllowRedirection <Boole değeri>
değeri $True
, bağlantının hedef bilgisayarlara yeniden yönlendirilmesini sağlar.
değerinin $False
hiçbir etkisi yoktur. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
PS Bağlan ionURI parametresini kullandığınızda, uzak hedef farklı bir URI'ye yönlendirme yönergesi döndürebilir. Varsayılan olarak, Windows PowerShell bağlantıları yeniden yönlendirmez, ancak bağlantının hedef bilgisayara yeniden yönlendirilmesine izin vermek için PSAllowRedirection parametresini değeriyle $True
kullanabilirsiniz.
Ayrıca, tercih değişkeninin Maximum Bağlan ionRedirectionCount özelliğini veya oturum oluşturan cmdlet'lerin SessionOption parametresinin değerinin Maximum Bağlan ionRedirectionCount özelliğini ayarlayarak bağlantının yeniden yönlendirilme sayısını sınırlayabilirsiniz.$PSSessionOption
Varsayılan değer şudur: 5
.
PSApplicationName <Dizesi>
Hedef bilgisayarlara bağlanmak için kullanılan bağlantı URI'sinin uygulama adı kesimini belirtir. Komutta Bağlan ionURI parametresini kullanmadığınızda uygulama adını belirtmek için bu parametreyi kullanın. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Varsayılan değer, hedef bilgisayardaki tercih değişkeninin değeridir $PSSessionApplicationName
. Bu tercih değişkeni tanımlanmamışsa, varsayılan değer WSMAN'dır. Bu değer çoğu kullanım için uygundur. Daha fazla bilgi için bkz . about_Preference_Variables.
WinRM hizmeti, bağlantı isteğine hizmet vermek üzere bir dinleyici seçmek için uygulama adını kullanır. Bu parametrenin değeri, uzak bilgisayardaki dinleyicinin URLPrefix özelliğinin değeriyle eşleşmelidir.
PSAuthentication <AuthenticationMechanism>
Hedef bilgisayarlara bağlanırken kullanıcının kimlik bilgilerini doğrulamak için kullanılan mekanizmayı belirtir. Geçerli değerler , , Basic
, CredSSP
, Digest
, Kerberos
, Negotiate
ve NegotiateWithImplicitCredential
değerleridirDefault
. Varsayılan değer şudur: Default
. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Bu parametrenin değerleri hakkında bilgi için PowerShell SDK'sında System.Management.Automation.Runspaces.AuthenticationMechanism numaralandırmasının açıklamasına bakın.
Uyarı
Kullanıcının kimlik bilgilerinin kimlik doğrulaması için uzak bir bilgisayara geçirildiği Kimlik Bilgisi Güvenlik Hizmeti Sağlayıcısı (CredSSP) kimlik doğrulaması, uzak ağ paylaşımına erişme gibi birden fazla kaynakta kimlik doğrulaması gerektiren komutlar için tasarlanmıştır. Bu mekanizma, uzak işlemin güvenlik riskini artırır. Uzak bilgisayarın güvenliği aşılırsa, bu bilgisayara geçirilen kimlik bilgileri ağ oturumunu denetlemek için kullanılabilir.
PSCertificateThumbprint <Dizesi>
Bu eylemi gerçekleştirme izni olan bir kullanıcı hesabının dijital ortak anahtar sertifikasını (X509) belirtir. Sertifikanın sertifika parmak izini girin. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Sertifikalar, istemci sertifikası tabanlı kimlik doğrulamasında kullanılır. Bunlar yalnızca yerel kullanıcı hesaplarıyla eşlenebilir; etki alanı hesaplarıyla çalışmaz.
Sertifika almak için Windows PowerShell Cert:
sürücüsündeki Get-Item veya Get-ChildItem cmdlet'lerini kullanın.
PSComputerName <Dizesi[]>
Etkinliğin çalıştırıldığı hedef bilgisayarları belirtir. Varsayılan, yerel bilgisayardır. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Virgülle ayrılmış bir listeye bir veya daha fazla bilgisayarın NETBIOS adını, IP adresini veya tam etki alanı adını yazın. Yerel bilgisayarı belirtmek için bilgisayar adını, localhost
veya bir nokta (.
) yazın.
Yerel bilgisayarı PSComputerName parametresinin değerine eklemek için Yönetici olarak çalıştır seçeneğiyle Windows PowerShell'i açın.
Bu parametre komuttan atlanırsa veya değer veya boş bir dizeyse $null
, iş akışı hedefi yerel bilgisayardır ve komutu çalıştırmak için Windows PowerShell uzaktan iletişimi kullanılmaz.
ComputerName parametresinin değerinde bir IP adresi kullanmak için komutun PSCredential parametresini içermesi gerekir. Ayrıca, bilgisayar HTTPS aktarımı için yapılandırılmalıdır veya uzak bilgisayarın IP adresi yerel bilgisayardaki WinRM TrustedHosts listesine eklenmelidir. TrustedHosts listesine bilgisayar adı ekleme yönergeleri için, about_Remote_Troubleshooting'de "Güvenilen Ana Bilgisayar Listesine Bilgisayar Ekleme" bölümüne bakın.
PSConfigurationName <Dizesi>
Hedef bilgisayarlarda oturum oluşturmak için kullanılan oturum yapılandırmalarını belirtir. Hedef bilgisayarlarda oturum yapılandırmasının adını girin (iş akışını çalıştıran bilgisayarda değil). Varsayılan değer Microsoft.PowerShell.Workflow'dır. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
PS Bağlan ionRetryCount <UInt>
İlk bağlantı girişimi başarısız olursa her hedef bilgisayara bağlanma denemesi sayısı üst sınırını belirtir. 1 ile 4.294.967.295 (UInt.MaxValue) arasında bir sayı girin. Sıfır (0
) varsayılan değeri, yeniden deneme girişimini temsil eder. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
PS Bağlan ionRetryIntervalSec <UInt>
Bağlantı yeniden deneme girişimleri arasındaki gecikmeyi saniye cinsinden belirtir. Varsayılan değer sıfırdır (0
). Bu parametre yalnızca PS Bağlan ionRetryCount değeri en az 1 olduğunda geçerlidir. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
PS Bağlan ionURI <System.Uri>
Hedef bilgisayardaki etkinlik için bağlantı uç noktasını tanımlayan tekdüzen Kaynak Tanımlayıcısı (URI) belirtir. URI tam olarak nitelenmiş olmalıdır. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Bu dizenin biçimi aşağıdaki gibidir:
<Transport>://<ComputerName>:<Port>/<ApplicationName>
Varsayılan değer şudur: http://localhost:5985/WSMAN
.
PS Bağlan ionURI belirtmezseniz PSUseSSL, PSComputerName, PSPort ve PSApplicationName parametrelerini kullanarak PS Bağlan ionURI değerlerini belirtebilirsiniz.
URI'nin Aktarım kesimi için geçerli değerler ve HTTPS
şeklindedirHTTP
. Aktarım kesimiyle bir bağlantı URI'sini belirtir, ancak bağlantı noktası belirtmezseniz, oturum standart bağlantı noktalarıyla oluşturulur: 80
HTTP ve 443
HTTPS için.
Windows PowerShell uzaktan iletişiminde varsayılan bağlantı noktalarını kullanmak için HTTP veya 5986
HTTPS için bağlantı noktası 5985
belirtin.
PSCredential <PSCredential>
Etkinliği hedef bilgisayarda çalıştırma izni olan bir kullanıcı hesabı belirtir. Varsayılan, mevcut kullanıcıdır. Bu parametre yalnızca PSComputerName parametresi komuta eklendiğinde geçerlidir. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
veya gibi User01
bir kullanıcı adı yazın veya cmdlet'in döndürdüğü gibi PSCredential nesnesi Get-Credential
içeren bir değişken Domain01\User01
girin. Yalnızca bir kullanıcı adı girerseniz parola girmeniz istenir.
PSDebug <PSDataCollection[DebugRecord]>
Hata ayıklama iletilerini konsola veya iş akışı işinin Debug özelliğinin değerine yazmak yerine, etkinlikten gelen hata ayıklama iletilerini belirtilen hata ayıklama kaydı koleksiyonuna ekler. Aynı hata ayıklama kaydı koleksiyonu nesnesine birden çok etkinlikten hata ayıklama iletileri ekleyebilirsiniz.
Bu etkinlik ortak parametresini kullanmak için cmdlet'ini New-Object
kullanarak DebugRecord türünde bir PSDataCollection nesnesi oluşturun ve nesneyi bir değişkene kaydedin. Ardından, aşağıdaki örnekte gösterildiği gibi bir veya daha fazla etkinliğin PSDebug parametresinin değeri olarak değişkenini kullanın.
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 <Boole değeri>
Etkinliği iş akışına "canlı" (serileştirilmemiş) nesneler döndürmeye yönlendirir. Sonuçta elde edilen nesnelerin yöntemleri ve özellikleri vardır, ancak bir denetim noktası alındığında kaydedilemezler.
PSDisableSerializationPreference <Boole değeri>
PSDisableSerialization parametresinin eşdeğerini yalnızca etkinliği değil iş akışının tamamına uygular. Bu parametrenin eklenmesi genellikle önerilmez çünkü nesnelerini serileştirmeyen bir iş akışı sürdürülemez veya kalıcı hale getirilemez.
Geçerli değerler:
(Varsayılan) Atlanırsa ve bir etkinliğe PSDisableSerialization parametresini eklemediyseniz, nesneler seri hale getirilir.
$True
. Bir iş akışı içindeki tüm etkinlikleri "canlı" (serileştirilmemiş) nesneler döndürmeye yönlendirir. Sonuçta elde edilen nesnelerin yöntemleri ve özellikleri vardır, ancak bir denetim noktası alındığında kaydedilemezler.$False
. İş akışı nesneleri serileştirilir.
PSError <PSDataCollection[ErrorRecord]>
Hata iletilerini konsola veya iş akışı işinin Error özelliğinin değerine yazmak yerine etkinlikten belirtilen hata kaydı koleksiyonuna hata iletileri ekler. Aynı hata kaydı koleksiyonu nesnesine birden çok etkinlikten hata iletileri ekleyebilirsiniz.
Bu etkinlik ortak parametresini kullanmak için cmdlet'ini New-Object
kullanarak ErrorRecord türünde bir PSDataCollection nesnesi oluşturun ve nesneyi bir değişkene kaydedin. Ardından, aşağıdaki örnekte gösterildiği gibi bir veya daha fazla etkinliğin PSError parametresinin değeri olarak değişkenini kullanın.
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 <Boole değeri>
Etkinlik sonrasında bir denetim noktası alır. Bu denetim noktası, iş akışında belirtilen denetim noktalarına ek olarak sağlanır. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
"Denetim noktası" veya "kalıcılık noktası", iş akışı çalışırken yakalanan ve disk üzerindeki bir kalıcılık deposuna kaydedilen iş akışı durumunun ve verilerin anlık görüntüsüdür. Windows PowerShell İş Akışı, kaydedilen verileri kullanarak iş akışını yeniden başlatmak yerine son kalıcılık noktasından askıya alınmış veya kesintiye uğramış bir iş akışını sürdürür.
Geçerli değerler:
(Varsayılan) Bu parametreyi atlarsanız, hiçbir denetim noktası eklenmez. Denetim noktaları, iş akışının ayarlarına göre alınır.
$True
. Etkinlik tamamlandıktan sonra bir denetim noktası alır. Bu denetim noktası, iş akışında belirtilen denetim noktalarına ek olarak sağlanır.$False
. Denetim noktası eklenmez. Denetim noktaları yalnızca iş akışında belirtildiğinde alınır.
PSPort <Int32>
Hedef bilgisayarlardaki ağ bağlantı noktasını belirtir. Varsayılan bağlantı noktaları ( 5985
HTTP için WinRM bağlantı noktası) ve 59'86 'dır (HTTPS için WinRM bağlantı noktası). Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
PsPort parametresini kullanmadığınız sürece kullanmayın. Komutta ayarlanan bağlantı noktası, komutun çalıştığı tüm bilgisayarlar veya oturumlar için geçerlidir. Alternatif bir bağlantı noktası ayarı, komutun tüm bilgisayarlarda çalışmasını engelleyebilir. Alternatif bir bağlantı noktası kullanmadan önce, uzak bilgisayardaki WinRM dinleyicisini bu bağlantı noktasını dinleyecek şekilde yapılandırmanız gerekir.
PSProgress <PSDataCollection[ProgressRecord]>
İlerleme iletilerini konsola veya iş akışı işinin Progress özelliğinin değerine yazmak yerine etkinlikten ilerleme iletilerini belirtilen ilerleme kaydı koleksiyonuna ekler. Aynı ilerleme kaydı koleksiyonu nesnesine birden çok etkinlikten ilerleme iletileri ekleyebilirsiniz.
PSProgressMessage <Dizesi>
Etkinliğin kolay açıklamasını belirtir. İş akışı çalışırken ilerleme çubuğunda PSProgressMessage değeri görüntülenir. DisplayName komutuna da eklendiğinde, ilerleme çubuğu içeriği biçimde görünür<DisplayName>:<PSProgressMessage>
.
Bu parametre özellikle bir ForEach -Parallel
betik bloğundaki etkinlikleri tanımlamak için kullanışlıdır. Bu ileti olmadan, tüm paralel dallardaki etkinlikler aynı adla tanımlanır.
PSRemotingBehavior <RemotingBehavior>
Etkinlik hedef bilgisayarlarda çalıştırıldığında uzaktan iletişimin nasıl yönetildiğini belirtir. PowerShell varsayılandır.
Geçerli değerler:
None
: Etkinlik uzak bilgisayarlarda çalıştırılmaz.PowerShell
: Windows PowerShell uzaktan iletişim özelliği, etkinliği hedef bilgisayarlarda çalıştırmak için kullanılır.Custom
: Etkinlik kendi uzaktan iletişim türünü destekler. Bu değer, etkinlik olarak uygulanan cmdlet RemotingCapability özniteliğinin değerini SupportedByCommand olarak ayarladığında ve komut ComputerName parametresini içerdiğinde geçerlidir.
PSRequiredModules <Dizesi[]>
Komutu çalıştırmadan önce belirtilen modülleri içeri aktarır. Modül adlarını girin. Modüllerin hedef bilgisayara yüklenmesi gerekir.
PSModulePath ortam değişkeninde belirtilen bir yola yüklenen modüller, modüldeki herhangi bir komutun ilk kullanımında otomatik olarak içeri aktarılır. PSModulePath konumunda olmayan modülleri içeri aktarmak için bu parametreyi kullanın.
bir iş akışındaki her etkinlik kendi oturumunda çalıştığından, komut Import-Module
bir modülü yalnızca çalıştığı oturuma aktarır. Modülü diğer etkinliklerin çalıştığı oturumlara aktarmaz.
PSSessionOption <PSSessionOption>
Oturumlar için gelişmiş seçenekleri hedef bilgisayarlara ayarlar. cmdlet'ini kullanarak New-PSSessionOption
oluşturduğunuz pssessionOption nesnesi gibi bir nesne girin. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
Oturum seçeneklerinin varsayılan değerleri, ayarlanmışsa tercih değişkeninin $PSSessionOption
değeriyle belirlenir. Aksi takdirde oturum, oturum yapılandırmasında belirtilen değerleri kullanır.
Varsayılan değerler de dahil olmak üzere oturum seçeneklerinin açıklaması için New-PSSessionOption cmdlet'i New-PSSessionOption için yardım konusuna bakın.
Tercih değişkeni hakkında $PSSessionOption
daha fazla bilgi için bkz . about_Preference_Variables.
PSUsesSL <Boole değeri>
değeri $True
, hedef bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunu kullanır. Varsayılan olarak SSL kullanılmaz. değerinin $False
hiçbir etkisi yoktur. Bu etkinlik ortak parametresi aynı zamanda bir iş akışı ortak parametresidir.
WS-Management, ağ üzerinden iletilen tüm Windows PowerShell içeriğini şifreler. UseSSL , verileri HTTP yerine https üzerinden gönderen ek bir korumadır. Bu parametreyi kullanıyorsanız ancak komut için kullanılan bağlantı noktasında SSL kullanılamıyorsa, komut başarısız olur.
PSVerbose <PSDataCollection[VerboseRecord]>
Konsola veya iş akışı işinin Ayrıntılı özelliğinin değerine ayrıntılı iletiler yazmak yerine etkinlikten belirtilen ayrıntılı kayıt koleksiyonuna ayrıntılı iletiler ekler. Aynı ayrıntılı kayıt koleksiyonu nesnesine birden çok etkinlikten ayrıntılı iletiler ekleyebilirsiniz.
PSWarning <PSDataCollection[WarningRecord]>
Konsola veya iş akışı işinin Warning özelliğinin değerine uyarı iletileri yazmak yerine etkinlikten belirtilen uyarı kaydı koleksiyonuna uyarı iletileri ekler. Aynı uyarı kaydı koleksiyonu nesnesine birden çok etkinlikten uyarı iletileri ekleyebilirsiniz.
Sonuç
Bu parametre yalnızca XAML iş akışlarında geçerlidir.
UseDefaultInput <Boolean>
Tüm iş akışı girişini değere göre etkinliğe giriş olarak kabul eder.
Örneğin, aşağıdaki örnek iş akışındaki etkinlik, Get-Process
iş akışına geçirilen girişi almak için UseDefaultInput etkinliği ortak parametresini kullanır. İş akışını girişle çalıştırdığınızda, bu giriş etkinlik tarafından kullanılır.
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
<Ayrıntılı SwitchParameter>
komutu tarafından gerçekleştirilen işlemle ilgili ayrıntılı bilgileri görüntüler. Bu bilgiler, izlemedeki veya işlem günlüğündeki bilgilere benzer. Verbose parametresi, geçerli komut için değişkenin $VerbosePreference
değerini geçersiz kılar. Bu parametre yalnızca komut ayrıntılı bir ileti oluşturduğunda çalışır. Bu parametre aynı zamanda bir Windows PowerShell ortak parametresidir.
WarningAction <ActionPreference>
Etkinliğin bir uyarıya nasıl yanıt vereceğini belirler. Continue
varsayılan değerdir. WarningAction parametresi, geçerli komut için değişkenin $WarningPreference
değerini geçersiz kılar. Bu parametre yalnızca komut bir uyarı iletisi oluşturduğunda çalışır. Bu parametre aynı zamanda bir Windows PowerShell ortak parametresidir.
Geçerli değerler:
SilentlyContinue
. Uyarı iletisini gizler ve komutu yürütmeye devam eder.Continue
. Uyarı iletisini görüntüler ve komutu yürütmeye devam eder.Continue
varsayılan değerdir.Inquire
. Uyarı iletisini görüntüler ve yürütmeye devam etmeden önce sizden onay ister. Bu değer nadiren kullanılır.Stop
. Uyarı iletisini görüntüler ve komutu yürütmeyi durdurur.
Not
WarningAction parametresi, komutta betik veya işlev çalıştırmak için kullanıldığında tercih değişkeninin değerini $WarningAction
geçersiz kılmaz.
ÖRNEKLER
Etkinlik ortak parametreleri son derece kullanışlıdır. Örneğin, hedef bilgisayarların yalnızca bir alt kümesinde belirli etkinlikleri çalıştırmak için PSComputerName parametresini kullanabilirsiniz.
Alternatif olarak, belirli etkinliklerin yeniden deneme değerlerini ayarlamak için PS Bağlan ionRetryCount ve PS Bağlan ionRetryIntervalSec parametrelerini kullanabilirsiniz.
Aşağıdaki örnekte, pscomputerName etkinliği ortak parametrelerini kullanarak etkinliği yalnızca belirli bir Get-EventLog
etki alanına ait bilgisayarlarda çalıştırma işlemi gösterilmektedir.
Workflow Test-Workflow
{
$UserDomain = Get-Content -Path '.\UserComputers.txt'
$Log = (Get-EventLog -LogName "Windows PowerShell" `
-PSComputerName $UserDomain)
if ($Log)
{
# Do Work Here.
}
}
Ayrıca bkz:
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin