Share via

about_WorkflowCommonParameters

  • Makale

KıSA AÇıKLAMA

Bu konuda, tüm Windows PowerShell iş akışı komutlarında geçerli olan parametreler açıklanmaktadır. Windows PowerShell altyapısı bunları iş akışlarına eklediğinden, bu parametreleri herhangi bir iş akışında kullanabilirsiniz ve bunlar sizin oluşturduğunuz iş akışlarında otomatik olarak etkinleştirilir.

UZUN AÇıKLAMA

Windows PowerShell İş Akışı ortak parametreleri, tüm Windows PowerShell iş akışları ve etkinlikleriyle kullanabileceğiniz bir cmdlet parametreleri kümesidir. Bunlar iş akışı yazarı tarafından değil Windows PowerShell İş Akışı altyapısı tarafından eklenir ve iş akışları ve etkinliklerde otomatik olarak kullanılabilir. Ancak, üç düzey derin iç içe geçmiş iş akışları, iş akışı ortak parametreleri de dahil olmak üzere herhangi bir ortak parametreyi desteklemez.

Tüm iş akışı parametreleri isteğe bağlıdır ve adlandırılır (konumsal değildir). İşlem hattından giriş almazlar.

İş akışı ortak parametrelerinin çoğunda PSComputerName ve PSCredential gibi bir PS ön ek vardır. PS ön ekli parametreler, "uzak düğümler" olarak da bilinen hedef bilgisayarlar için bağlantıyı ve yürütme ortamını yapılandırıyor.

PSAllowRedirection ve AsJob gibi iş akışı ortak parametrelerinin çoğunda, Windows PowerShell uzaktan iletişim ve arka plan işlerinde kullanılan parametrelere benzer adlar bulunur. Bu parametreler benzer adlı uzaktan iletişim ve iş parametreleriyle aynı şekilde çalışır, böylece iş akışlarını yönetmek için uzaktan iletişim ve işlerde geliştirdiğiniz bilgileri kullanabilirsiniz.

İş akışları Windows PowerShell 3.0'da kullanıma sunulmuştur.

PARAMETRE AÇıKLAMALARı

Bu bölümde iş akışı ortak parametreleri açıklanmaktadır.

-AsJob <SwitchParameter>

İş akışını iş akışı işi olarak çalıştırır. İş akışı komutu hemen üst işi temsil eden bir nesne döndürür. Üst iş, hedef bilgisayarların her birinde çalışan alt işleri içerir. İşi yönetmek için İş cmdlet'lerini kullanın. İş sonuçlarını almak için Receive-Job kullanın.

-JobName <Dizesi>

İş akışı işi için kolay bir ad belirtir. Varsayılan olarak, işler olarak adlandırılır Job<n>; burada <n> bir sıra numarasıdır.

İş akışı komutunda JobName parametresini kullanırsanız, iş akışı bir iş olarak çalıştırılır ve komuta AsJob parametresini eklemeseniz bile iş akışı komutu bir iş nesnesi döndürür.

Windows PowerShell arka plan işleri hakkında daha fazla bilgi için bkz . about_Jobs.

-PSAllowRedirection <SwitchParameter>

Bağlantının hedef bilgisayarlara yeniden yönlendirilmesine izin verir.

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 kullanabilirsiniz.

Ayrıca tercih değişkeninin Maximum Bağlan ionRedirectionCount özelliğini veya PSSessionOption parametresinin değerinin $PSSessionOption Maximum Bağlan ionRedirectionCount özelliğini ayarlayarak bağlantının yeniden yönlendirilme sayısını sınırlayabilirsiniz. Varsayılan değer şudur: 5. Daha fazla bilgi için PSSessionOption parametresinin ve New-PSSessionOption'ın açıklamasına bakın.

-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.

Varsayılan değer, yerel bilgisayardaki tercih değişkeninin değeridir $PSSessionApplicationName . Bu tercih değişkeni tanımlanmamışsa, varsayılan değer olur WSMAN. 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:

  • Default
  • Basic
  • Credssp
  • Digest
  • Kerberos
  • Negotiate
  • NegotiateWithImplicitCredential

Varsayılan değer şudur: Default.

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.

-PSAuthenticationLevel <AuthenticationLevel>

Hedef bilgisayarlara yönelik bağlantıların kimlik doğrulama düzeyini belirtir. Varsayılan değer şudur: Default.

Geçerli değerler:

Veri Akışı Adı Açıklama
Unchanged Kimlik doğrulama düzeyi önceki komutla aynıdır.
Default Windows Kimlik Doğrulaması.
None COM kimlik doğrulaması yok.
Connect Bağlan düzeyinde COM kimlik doğrulaması.
Call Çağrı düzeyi COM kimlik doğrulaması.
Packet Paket düzeyi COM kimlik doğrulaması.
PacketIntegrity Paket Bütünlüğü düzeyi COM kimlik doğrulaması.
PacketPrivacy Paket Gizlilik düzeyi COM kimlik doğrulaması.

-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.

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[]>

İş akışının hedef düğümleri olan bilgisayarların listesini belirtir. Bir iş akışındaki komutlar veya etkinlikler, bu parametre kullanılarak belirtilen bilgisayarlarda çalıştırılır. Varsayılan, yerel bilgisayardır.

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ı, localhostveya 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 oturumları yapılandırmak için kullanılan oturum yapılandırmalarını belirtir. Hedef bilgisayarlarda (iş akışı sunucusu bilgisayarında değil) bir oturum yapılandırması girin. Varsayılan değer Microsoft.PowerShell.Workflow'dır.

-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.

-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 1olduğunda geçerlidir.

-PS Bağlan ionURI <System.Uri>

Hedef bilgisayardaki iş akışı için bağlantı uç noktasını tanımlayan bir Tekdüzen Kaynak Tanımlayıcısı (URI) belirtir. URI tam olarak nitelenmiş olmalıdır.

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 HTTP ve HTTPS'dir. 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>

Hedef bilgisayarda iş akışı ç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.

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\User01girin. Yalnızca bir kullanıcı adı girerseniz parola girmeniz istenir.

-PSElapsedTimeoutSec <UInt32>

İş akışının ve tüm ilgili kaynakların sistemde ne kadar süreyle tutuldığını belirler. Zaman aşımı süresi dolduğunda, iş akışı hala işleniyor olsa bile silinir. 10 ile 4.294.967.295 arasında bir değer girin. Varsayılan değer 0 (sıfır), geçen zaman aşımı olmadığı anlamına gelir.

-PSParameterCollection <Hashtable[]>

Farklı hedef bilgisayarlar için farklı iş akışı ortak parametre değerlerini belirtir.

Her hedef bilgisayar için bir karma tablo içeren karma tabloların virgülle ayrılmış bir listesini girin. Her karma tabloda ilk anahtar PSComputerName , değeri ise hedef bilgisayarın adıdır. Bilgisayar adında joker karakterlere izin verilir. Karma tablodaki kalan anahtarlar için anahtar parametre adı ve değer parametre değeridir.

Örneğin:

-PSParameterCollection @{PSComputerName="*"; PSElapsedTimeoutSec=20},
@{PSComputerName="Server02"},
@{PSComputerName="Server03"},
@{PSComputerName="Server01"; PSElapsedTimeoutSec=10}

Yukarıdaki örnekte, varsayılan değeri saniye cinsinden kendi zaman aşımını 10 belirterek geçersiz kılan Server01 dışında tüm bağlantıların 20 saniye cinsinden varsayılan PSElapsedTimeoutSec değeri olacaktır.

-PSPersist <Boole değeri>

İş akışında belirtilen denetim noktalarına ek olarak iş akışına denetim noktaları ekler.

Bu parametre, PSPersist etkinliği ortak parametresi, etkinlik veya değişken kullanılarak belirtilenler gibi bir iş akışındaki Checkpoint-Workflow denetim noktalarını gizleyemez$PSPersistPreference.

"Denetim noktası" veya "kalıcılık noktası", iş akışı çalışırken yakalanan ve diskteki veya SQL veritabanındaki bir kalıcılık deposuna kaydedilen iş akışı durumunun ve verilerinin 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, iş akışında belirtilen denetim noktalarına ek olarak iş akışının başına ve sonuna bir denetim noktası eklenir.

  • $True. İş akışında belirtilen denetim noktalarına ek olarak, iş akışının başına ve sonuna bir denetim noktası ve her etkinlik sonrasında bir denetim noktası ekler.

  • $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ı şunlardır 5985 (HTTP için WinRM bağlantı noktası) ve 5986 (HTTPS için WinRM bağlantı noktası).

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.

-PSPrivateMetadata <Hashtable>

İş akışı işlerine özelleştirilmiş bilgiler sağlar. Karma tablo girin. Anahtarlar ve değerler her iş akışı için özelleştirilir. Bir iş akışının özel meta verileri hakkında bilgi için iş akışının yardım konusuna bakın.

Bu parametre Windows PowerShell İş Akışı altyapısı tarafından işlenmez. Bunun yerine, altyapı karma tablosunu doğrudan iş akışına geçirir.

-PSRunningTimeoutSec <UInt32>

İş akışının askıya alındığı her zaman hariç, iş akışının çalışma süresini saniye olarak belirtir. Süre dolduğunda iş akışı yürütmesi tamamlanmazsa, Windows PowerShell İş Akışı altyapısı iş akışının yürütülmesini zorla durdurur.

-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.

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 bkz . New-PSSessionOption. Tercih değişkeni hakkında $PSSessionOption bilgi için bkz . about_Preference_Variables.

-PSUsesSL <SwitchParameter>

Hedef bilgisayara bağlantı kurmak için Güvenli Yuva Katmanı (SSL) protokolunu kullanır. Varsayılan olarak SSL kullanılmaz.

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.

Ayrıca bkz: