PoshCode Archive  Hex Artifact Content

Artifact d4c8ea2e2024bf8469f626eebc7fd21e75ba380fbd320200dd23475bd6325bb1:

  • File Select-Random.ps1 — part of check-in [9a51cb952b] at 2018-06-10 12:56:36 on branch trunk — Select a user-defined number of random elements from the collection … which can be passed as a parameter or input via the pipeline. An improvement over http://www.powershellcentral.com/scripts/60 which allows you to select more than one item, but offers the option to collect the pipeline into RAM to trade speed for memory use (replaces 81 and 83). (user: Joel Bennett size: 4643)

0000: 23 20 65 6e 63 6f 64 69 6e 67 3a 20 61 73 63 69  # encoding: asci
0010: 69 0d 0a 23 20 61 70 69 3a 20 70 6f 77 65 72 73  i..# api: powers
0020: 68 65 6c 6c 0d 0a 23 20 74 69 74 6c 65 3a 20 53  hell..# title: S
0030: 65 6c 65 63 74 2d 52 61 6e 64 6f 6d 0d 0a 23 20  elect-Random..# 
0040: 64 65 73 63 72 69 70 74 69 6f 6e 3a 20 53 65 6c  description: Sel
0050: 65 63 74 20 61 20 75 73 65 72 2d 64 65 66 69 6e  ect a user-defin
0060: 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 72 61 6e  ed number of ran
0070: 64 6f 6d 20 65 6c 65 6d 65 6e 74 73 20 66 72 6f  dom elements fro
0080: 6d 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e  m the collection
0090: 20 e2 80 a6 20 77 68 69 63 68 20 63 61 6e 20 62   ... which can b
00a0: 65 20 70 61 73 73 65 64 20 61 73 20 61 20 70 61  e passed as a pa
00b0: 72 61 6d 65 74 65 72 20 6f 72 20 69 6e 70 75 74  rameter or input
00c0: 20 76 69 61 20 74 68 65 20 70 69 70 65 6c 69 6e   via the pipelin
00d0: 65 2e 20 41 6e 20 69 6d 70 72 6f 76 65 6d 65 6e  e. An improvemen
00e0: 74 20 6f 76 65 72 20 68 74 74 70 3a 2f 2f 77 77  t over http://ww
00f0: 77 2e 70 6f 77 65 72 73 68 65 6c 6c 63 65 6e 74  w.powershellcent
0100: 72 61 6c 2e 63 6f 6d 2f 73 63 72 69 70 74 73 2f  ral.com/scripts/
0110: 36 30 20 77 68 69 63 68 20 61 6c 6c 6f 77 73 20  60 which allows 
0120: 79 6f 75 20 74 6f 20 73 65 6c 65 63 74 20 6d 6f  you to select mo
0130: 72 65 20 74 68 61 6e 20 6f 6e 65 20 69 74 65 6d  re than one item
0140: 2c 20 62 75 74 20 6f 66 66 65 72 73 20 74 68 65  , but offers the
0150: 20 6f 70 74 69 6f 6e 20 74 6f 20 63 6f 6c 6c 65   option to colle
0160: 63 74 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20  ct the pipeline 
0170: 69 6e 74 6f 20 52 41 4d 20 74 6f 20 74 72 61 64  into RAM to trad
0180: 65 20 73 70 65 65 64 20 66 6f 72 20 6d 65 6d 6f  e speed for memo
0190: 72 79 20 75 73 65 20 28 72 65 70 6c 61 63 65 73  ry use (replaces
01a0: 20 38 31 20 61 6e 64 20 38 33 29 2e 0d 0a 23 20   81 and 83)...# 
01b0: 76 65 72 73 69 6f 6e 3a 20 32 2e 32 0d 0a 23 20  version: 2.2..# 
01c0: 74 79 70 65 3a 20 73 63 72 69 70 74 0d 0a 23 20  type: script..# 
01d0: 61 75 74 68 6f 72 3a 20 4a 6f 65 6c 20 42 65 6e  author: Joel Ben
01e0: 6e 65 74 74 0d 0a 23 20 6c 69 63 65 6e 73 65 3a  nett..# license:
01f0: 20 43 43 30 0d 0a 23 20 78 2d 70 6f 73 68 63 6f   CC0..# x-poshco
0200: 64 65 2d 69 64 3a 20 31 31 38 0d 0a 23 20 78 2d  de-id: 118..# x-
0210: 61 72 63 68 69 76 65 64 3a 20 32 30 31 33 2d 30  archived: 2013-0
0220: 35 2d 30 35 54 31 30 3a 35 37 3a 30 39 0d 0a 23  5-05T10:57:09..#
0230: 20 78 2d 70 75 62 6c 69 73 68 65 64 3a 20 32 30   x-published: 20
0240: 30 38 2d 30 31 2d 32 30 54 32 31 3a 31 30 3a 30  08-01-20T21:10:0
0250: 30 0d 0a 23 0d 0a 23 0d 0a 23 20 2d 2d 2d 2d 2d  0..#..#..# -----
0260: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0270: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0280: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
0290: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
02a0: 2d 2d 2d 2d 2d 2d 0d 0a 23 23 23 20 3c 53 63 72  ------..### <Scr
02b0: 69 70 74 3e 0d 0a 23 23 23 20 3c 41 75 74 68 6f  ipt>..### <Autho
02c0: 72 3e 0d 0a 23 23 23 20 4a 6f 65 6c 20 22 4a 61  r>..### Joel "Ja
02d0: 79 6b 75 6c 22 20 42 65 6e 6e 65 74 74 0d 0a 23  ykul" Bennett..#
02e0: 23 23 20 3c 2f 41 75 74 68 6f 72 3e 0d 0a 23 23  ## </Author>..##
02f0: 23 20 3c 44 65 73 63 72 69 70 74 69 6f 6e 3e 0d  # <Description>.
0300: 0a 23 23 23 20 53 65 6c 65 63 74 73 20 61 20 72  .### Selects a r
0310: 61 6e 64 6f 6d 20 65 6c 65 6d 65 6e 74 20 66 72  andom element fr
0320: 6f 6d 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f  om the collectio
0330: 6e 20 65 69 74 68 65 72 20 70 61 73 73 65 64 20  n either passed 
0340: 61 73 20 61 20 70 61 72 61 6d 65 74 65 72 20 6f  as a parameter o
0350: 72 20 69 6e 70 75 74 20 76 69 61 20 74 68 65 20  r input via the 
0360: 70 69 70 65 6c 69 6e 65 2e 0d 0a 23 23 23 20 49  pipeline...### I
0370: 66 20 74 68 65 20 63 6f 6c 6c 65 63 74 69 6f 6e  f the collection
0380: 20 69 73 20 70 61 73 73 65 64 20 69 6e 20 61 73   is passed in as
0390: 20 61 6e 20 61 72 67 75 6d 65 6e 74 2c 20 77 65   an argument, we
03a0: 20 73 69 6d 70 6c 79 20 70 69 63 6b 20 61 20 72   simply pick a r
03b0: 61 6e 64 6f 6d 20 6e 75 6d 62 65 72 20 62 65 74  andom number bet
03c0: 77 65 65 6e 20 30 20 61 6e 64 20 63 6f 75 6e 74  ween 0 and count
03d0: 2d 31 0d 0a 23 23 23 20 66 6f 72 20 65 61 63 68  -1..### for each
03e0: 20 65 6c 65 6d 65 6e 74 20 79 6f 75 20 77 61 6e   element you wan
03f0: 74 20 74 6f 20 72 65 74 75 72 6e 2c 20 62 75 74  t to return, but
0400: 20 77 68 65 6e 20 70 72 6f 63 65 73 73 69 6e 67   when processing
0410: 20 70 69 70 65 6c 69 6e 65 20 69 6e 70 75 74 20   pipeline input 
0420: 77 65 20 77 61 6e 74 20 74 6f 20 6b 65 65 70 20  we want to keep 
0430: 6d 65 6d 6f 72 79 20 75 73 65 20 0d 0a 23 23 23  memory use ..###
0440: 20 74 6f 20 61 20 6d 69 6e 69 6d 75 6d 2c 20 73   to a minimum, s
0450: 6f 20 77 65 20 75 73 65 20 61 20 22 72 65 73 65  o we use a "rese
0460: 72 76 6f 69 72 20 73 61 6d 70 6c 69 6e 67 22 20  rvoir sampling" 
0470: 61 6c 67 6f 72 69 74 68 6d 5b 31 5d 2e 0d 0a 23  algorithm[1]...#
0480: 23 23 0d 0a 23 23 23 20 5b 31 5d 20 68 74 74 70  ##..### [1] http
0490: 3a 2f 2f 67 72 65 67 61 62 6c 65 2e 63 6f 6d 2f  ://gregable.com/
04a0: 32 30 30 37 2f 31 30 2f 72 65 73 65 72 76 6f 69  2007/10/reservoi
04b0: 72 2d 73 61 6d 70 6c 69 6e 67 2e 68 74 6d 6c 0d  r-sampling.html.
04c0: 0a 23 23 23 0d 0a 23 23 23 20 54 68 65 20 73 63  .###..### The sc
04d0: 72 69 70 74 20 73 74 6f 72 65 73 20 24 63 6f 75  ript stores $cou
04e0: 6e 74 20 65 6c 65 6d 65 6e 74 73 20 28 74 68 65  nt elements (the
04f0: 20 65 76 65 6e 74 75 61 6c 20 72 65 73 75 6c 74   eventual result
0500: 29 20 61 74 20 61 6c 6c 20 74 69 6d 65 73 2e 20  ) at all times. 
0510: 49 74 20 63 6f 6e 74 69 6e 75 65 73 20 70 72 6f  It continues pro
0520: 63 65 73 73 69 6e 67 20 0d 0a 23 23 23 20 65 6c  cessing ..### el
0530: 65 6d 65 6e 74 73 20 75 6e 74 69 6c 20 69 74 20  ements until it 
0540: 72 65 61 63 68 65 73 20 74 68 65 20 65 6e 64 20  reaches the end 
0550: 6f 66 20 74 68 65 20 69 6e 70 75 74 2e 20 46 6f  of the input. Fo
0560: 72 20 65 61 63 68 20 69 6e 70 75 74 20 65 6c 65  r each input ele
0570: 6d 65 6e 74 20 24 6e 20 28 74 68 65 20 63 6f 75  ment $n (the cou
0580: 6e 74 20 6f 66 20 74 68 65 20 69 6e 70 75 74 73  nt of the inputs
0590: 20 0d 0a 23 23 23 20 73 6f 20 66 61 72 29 20 74   ..### so far) t
05a0: 68 65 72 65 20 69 73 20 61 20 24 63 6f 75 6e 74  here is a $count
05b0: 2f 24 6e 20 63 68 61 6e 63 65 20 74 68 61 74 20  /$n chance that 
05c0: 69 74 20 62 65 63 6f 6d 65 73 20 70 61 72 74 20  it becomes part 
05d0: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 2e 0d 0a  of the result...
05e0: 23 23 23 20 2a 20 46 6f 72 20 65 61 63 68 20 70  ### * For each p
05f0: 72 65 76 69 6f 75 73 6c 79 20 73 65 6c 65 63 74  reviously select
0600: 65 64 20 65 6c 65 6d 65 6e 74 2c 20 74 68 65 72  ed element, ther
0610: 65 20 69 73 20 61 20 24 63 6f 75 6e 74 2f 28 24  e is a $count/($
0620: 6e 2d 31 29 20 63 68 61 6e 63 65 20 6f 66 20 69  n-1) chance of i
0630: 74 20 62 65 69 6e 67 20 73 65 6c 65 63 74 65 64  t being selected
0640: 20 0d 0a 23 23 23 20 2a 20 46 6f 72 20 74 68 65   ..### * For the
0650: 20 6f 6e 65 73 20 73 65 6c 65 63 74 65 64 2c 20   ones selected, 
0660: 74 68 65 72 65 27 73 20 61 20 28 24 63 6f 75 6e  there's a ($coun
0670: 74 2f 24 6e 20 2a 20 31 2f 24 63 6f 75 6e 74 20  t/$n * 1/$count 
0680: 3d 20 31 2f 24 6e 29 20 63 68 61 6e 63 65 20 6f  = 1/$n) chance o
0690: 66 20 69 74 20 62 65 69 6e 67 20 72 65 70 6c 61  f it being repla
06a0: 63 65 64 2c 20 73 6f 20 61 20 0d 0a 23 23 23 20  ced, so a ..### 
06b0: 20 20 28 24 6e 2d 31 29 2f 24 6e 20 63 68 61 6e    ($n-1)/$n chan
06c0: 63 65 20 6f 66 20 69 74 20 72 65 6d 61 69 6e 69  ce of it remaini
06d0: 6e 67 20 2e 2e 2e 20 74 68 75 73 2c 20 69 74 27  ng ... thus, it'
06e0: 73 20 63 75 6d 75 6c 61 74 69 76 65 20 70 72 6f  s cumulative pro
06f0: 62 61 62 69 6c 69 74 79 20 6f 66 20 62 65 69 6e  bability of bein
0700: 67 20 61 6d 6f 6e 67 20 74 68 65 20 73 65 6c 65  g among the sele
0710: 63 74 65 64 0d 0a 23 23 23 20 20 20 65 6c 65 6d  cted..###   elem
0720: 65 6e 74 73 20 61 66 74 65 72 20 74 68 65 20 6e  ents after the n
0730: 74 68 20 69 6e 70 75 74 20 69 73 20 70 72 6f 63  th input is proc
0740: 65 73 73 65 64 20 69 73 20 24 63 6f 75 6e 74 2f  essed is $count/
0750: 28 24 6e 2d 31 29 20 2a 20 28 24 6e 2d 31 29 2f  ($n-1) * ($n-1)/
0760: 24 6e 20 3d 20 24 63 6f 75 6e 74 2f 24 6e 2c 20  $n = $count/$n, 
0770: 61 73 20 69 74 20 73 68 6f 75 6c 64 20 62 65 2e  as it should be.
0780: 0d 0a 23 23 23 0d 0a 23 23 23 20 3c 2f 44 65 73  ..###..### </Des
0790: 63 72 69 70 74 69 6f 6e 3e 0d 0a 23 23 23 20 3c  cription>..### <
07a0: 55 73 61 67 65 3e 0d 0a 23 23 23 20 24 61 72 72  Usage>..### $arr
07b0: 20 3d 20 31 2e 2e 35 3b 20 53 65 6c 65 63 74 2d   = 1..5; Select-
07c0: 52 61 6e 64 6f 6d 20 24 61 72 72 0d 0a 23 23 23  Random $arr..###
07d0: 20 31 2e 2e 31 30 20 7c 20 53 65 6c 65 63 74 2d   1..10 | Select-
07e0: 52 61 6e 64 6f 6d 20 2d 43 6f 75 6e 74 20 32 0d  Random -Count 2.
07f0: 0a 23 23 23 20 3c 2f 55 73 61 67 65 3e 0d 0a 23  .### </Usage>..#
0800: 23 23 20 3c 56 65 72 73 69 6f 6e 3e 32 2e 32 2e  ## <Version>2.2.
0810: 30 2e 30 3c 2f 56 65 72 73 69 6f 6e 3e 0d 0a 23  0.0</Version>..#
0820: 23 23 20 3c 48 69 73 74 6f 72 79 3e 0d 0a 23 23  ## <History>..##
0830: 23 20 3c 56 20 69 64 3d 22 32 2e 30 2e 30 2e 30  # <V id="2.0.0.0
0840: 22 3e 52 65 77 72 6f 74 65 20 75 73 69 6e 67 20  ">Rewrote using 
0850: 74 68 65 20 72 65 73 65 72 76 6f 69 72 20 73 61  the reservoir sa
0860: 6d 70 6c 69 6e 67 20 74 65 63 68 6e 69 71 75 65  mpling technique
0870: 3c 2f 56 3e 0d 0a 23 23 23 20 3c 56 20 69 64 3d  </V>..### <V id=
0880: 22 32 2e 31 2e 30 2e 30 22 3e 46 69 78 65 64 20  "2.1.0.0">Fixed 
0890: 61 20 62 75 67 20 69 6e 20 32 2e 30 20 77 68 69  a bug in 2.0 whi
08a0: 63 68 20 69 6e 76 65 72 74 65 64 20 74 68 65 20  ch inverted the 
08b0: 70 72 6f 62 61 62 69 6c 69 74 79 20 61 6e 64 20  probability and 
08c0: 72 65 73 75 6c 74 65 64 20 69 6e 20 74 68 65 20  resulted in the 
08d0: 6c 61 73 74 20 6e 20 69 74 65 6d 73 20 62 65 69  last n items bei
08e0: 6e 67 20 73 65 6c 65 63 74 65 64 20 77 69 74 68  ng selected with
08f0: 20 56 45 52 59 20 68 69 67 68 20 70 72 6f 62 61   VERY high proba
0900: 62 69 6c 69 74 79 3c 2f 56 3e 0d 0a 23 23 23 20  bility</V>..### 
0910: 3c 56 20 69 64 3d 22 32 2e 32 2e 30 2e 30 22 3e  <V id="2.2.0.0">
0920: 55 73 65 20 6d 6f 72 65 20 65 66 66 69 63 69 65  Use more efficie
0930: 6e 74 20 64 69 72 65 63 74 20 72 61 6e 64 6f 6d  nt direct random
0940: 20 73 61 6d 70 6c 69 6e 67 20 69 66 20 74 68 65   sampling if the
0950: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 69 73 20 70   collection is p
0960: 61 73 73 65 64 20 61 73 20 61 6e 20 61 72 67 75  assed as an argu
0970: 6d 65 6e 74 3c 2f 56 3e 0d 0a 23 23 23 20 3c 2f  ment</V>..### </
0980: 48 69 73 74 6f 72 79 3e 0d 0a 23 23 23 20 3c 2f  History>..### </
0990: 53 63 72 69 70 74 3e 0d 0a 23 20 2d 2d 2d 2d 2d  Script>..# -----
09a0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
09b0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
09c0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
09d0: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
09e0: 2d 2d 2d 2d 2d 2d 0d 0a 70 61 72 61 6d 28 5b 69  ------..param([i
09f0: 6e 74 5d 24 63 6f 75 6e 74 3d 31 2c 20 5b 73 77  nt]$count=1, [sw
0a00: 69 74 63 68 5d 24 63 6f 6c 6c 65 63 74 69 6f 6e  itch]$collection
0a10: 4d 65 74 68 6f 64 2c 20 5b 61 72 72 61 79 5d 24  Method, [array]$
0a20: 69 6e 70 75 74 4f 62 6a 65 63 74 3d 24 6e 75 6c  inputObject=$nul
0a30: 6c 29 20 0d 0a 0d 0a 42 45 47 49 4e 20 7b 0d 0a  l) ....BEGIN {..
0a40: 20 20 20 69 66 20 28 24 61 72 67 73 20 2d 65 71     if ($args -eq
0a50: 20 27 2d 3f 27 29 20 7b 0d 0a 40 22 0d 0a 55 73   '-?') {..@"..Us
0a60: 61 67 65 3a 20 53 65 6c 65 63 74 2d 52 61 6e 64  age: Select-Rand
0a70: 6f 6d 20 5b 5b 2d 43 6f 75 6e 74 5d 20 3c 69 6e  om [[-Count] <in
0a80: 74 3e 5d 20 5b 2d 69 6e 70 75 74 4f 62 6a 65 63  t>] [-inputObjec
0a90: 74 5d 20 3c 61 72 72 61 79 3e 20 28 66 72 6f 6d  t] <array> (from
0aa0: 20 70 69 70 65 6c 69 6e 65 29 20 5b 2d 3f 5d 0d   pipeline) [-?].
0ab0: 0a 0d 0a 50 61 72 61 6d 65 74 65 72 73 3a 0d 0a  ...Parameters:..
0ac0: 20 2d 43 6f 75 6e 74 20 20 20 20 20 20 20 20 20   -Count         
0ad0: 20 20 20 3a 20 54 68 65 20 6e 75 6d 62 65 72 20     : The number 
0ae0: 6f 66 20 65 6c 65 6d 65 6e 74 73 20 74 6f 20 73  of elements to s
0af0: 65 6c 65 63 74 2e 0d 0a 20 2d 69 6e 70 75 74 4f  elect... -inputO
0b00: 62 6a 65 63 74 20 20 20 20 20 20 3a 20 54 68 65  bject      : The
0b10: 20 63 6f 6c 6c 65 63 74 69 6f 6e 20 66 72 6f 6d   collection from
0b20: 20 77 68 69 63 68 20 74 6f 20 73 65 6c 65 63 74   which to select
0b30: 20 61 20 72 61 6e 64 6f 6d 20 65 6c 65 6d 65 6e   a random elemen
0b40: 74 2e 0d 0a 20 2d 63 6f 6c 6c 65 63 74 69 6f 6e  t... -collection
0b50: 4d 65 74 68 6f 64 20 3a 20 43 6f 6c 6c 65 63 74  Method : Collect
0b60: 20 74 68 65 20 70 69 70 65 6c 69 6e 65 20 69 6e   the pipeline in
0b70: 70 75 74 20 69 6e 73 74 65 61 64 20 6f 66 20 75  put instead of u
0b80: 73 69 6e 67 20 72 65 73 65 72 76 6f 69 72 0d 0a  sing reservoir..
0b90: 20 2d 3f 20 20 20 20 20 20 20 20 20 20 20 20 20   -?             
0ba0: 20 20 20 3a 20 44 69 73 70 6c 61 79 20 74 68 69     : Display thi
0bb0: 73 20 75 73 61 67 65 20 69 6e 66 6f 72 6d 61 74  s usage informat
0bc0: 69 6f 6e 20 61 6e 64 20 65 78 69 74 0d 0a 0d 0a  ion and exit....
0bd0: 45 78 61 6d 70 6c 65 73 3a 0d 0a 20 50 53 3e 20  Examples:.. PS> 
0be0: 24 61 72 72 20 3d 20 31 2e 2e 35 3b 20 53 65 6c  $arr = 1..5; Sel
0bf0: 65 63 74 2d 52 61 6e 64 6f 6d 20 24 61 72 72 0d  ect-Random $arr.
0c00: 0a 20 50 53 3e 20 31 2e 2e 31 30 20 7c 20 53 65  . PS> 1..10 | Se
0c10: 6c 65 63 74 2d 52 61 6e 64 6f 6d 20 2d 43 6f 75  lect-Random -Cou
0c20: 6e 74 20 32 0d 0a 0d 0a 22 40 0d 0a 65 78 69 74  nt 2...."@..exit
0c30: 0d 0a 20 20 20 7d 20 0d 0a 20 20 20 65 6c 73 65  ..   } ..   else
0c40: 0d 0a 20 20 20 7b 0d 0a 20 20 20 20 20 20 24 72  ..   {..      $r
0c50: 61 6e 64 20 3d 20 6e 65 77 2d 6f 62 6a 65 63 74  and = new-object
0c60: 20 52 61 6e 64 6f 6d 0d 0a 20 20 20 20 20 20 69   Random..      i
0c70: 66 20 28 24 69 6e 70 75 74 4f 62 6a 65 63 74 29  f ($inputObject)
0c80: 20 0d 0a 20 20 20 20 20 20 7b 0d 0a 20 20 20 20   ..      {..    
0c90: 20 20 20 20 20 23 20 57 72 69 74 65 2d 4f 75 74       # Write-Out
0ca0: 70 75 74 20 24 69 6e 70 75 74 4f 62 6a 65 63 74  put $inputObject
0cb0: 20 7c 20 26 28 24 4d 79 49 6e 76 6f 63 61 74 69   | &($MyInvocati
0cc0: 6f 6e 2e 49 6e 76 6f 63 61 74 69 6f 6e 4e 61 6d  on.InvocationNam
0cd0: 65 29 20 2d 43 6f 75 6e 74 20 24 63 6f 75 6e 74  e) -Count $count
0ce0: 0d 0a 20 20 20 20 20 20 7d 0d 0a 20 20 20 20 20  ..      }..     
0cf0: 20 65 6c 73 65 69 66 28 24 63 6f 6c 6c 65 63 74   elseif($collect
0d00: 69 6f 6e 4d 65 74 68 6f 64 29 0d 0a 20 20 20 20  ionMethod)..    
0d10: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 57 72    {..         Wr
0d20: 69 74 65 2d 56 65 72 62 6f 73 65 20 22 43 6f 6c  ite-Verbose "Col
0d30: 6c 65 63 74 69 6e 67 20 66 72 6f 6d 20 74 68 65  lecting from the
0d40: 20 70 69 70 65 6c 69 6e 65 20 22 0d 0a 20 20 20   pipeline "..   
0d50: 20 20 20 20 20 20 5b 43 6f 6c 6c 65 63 74 69 6f        [Collectio
0d60: 6e 73 2e 41 72 72 61 79 4c 69 73 74 5d 24 69 6e  ns.ArrayList]$in
0d70: 70 75 74 4f 62 6a 65 63 74 20 3d 20 6e 65 77 2d  putObject = new-
0d80: 6f 62 6a 65 63 74 20 43 6f 6c 6c 65 63 74 69 6f  object Collectio
0d90: 6e 73 2e 41 72 72 61 79 4c 69 73 74 0d 0a 20 20  ns.ArrayList..  
0da0: 20 20 20 20 7d 0d 0a 20 20 20 20 20 20 65 6c 73      }..      els
0db0: 65 0d 0a 20 20 20 20 20 20 7b 0d 0a 20 20 20 20  e..      {..    
0dc0: 20 20 20 20 20 24 73 65 65 6e 20 3d 20 30 0d 0a       $seen = 0..
0dd0: 20 20 20 20 20 20 20 20 20 24 73 65 6c 65 63 74           $select
0de0: 65 64 20 3d 20 6e 65 77 2d 6f 62 6a 65 63 74 20  ed = new-object 
0df0: 6f 62 6a 65 63 74 5b 5d 20 24 63 6f 75 6e 74 0d  object[] $count.
0e00: 0a 20 20 20 20 20 20 7d 0d 0a 20 20 20 7d 0d 0a  .      }..   }..
0e10: 7d 0d 0a 50 52 4f 43 45 53 53 20 7b 0d 0a 20 20  }..PROCESS {..  
0e20: 20 69 66 28 24 5f 29 0d 0a 20 20 20 7b 0d 0a 20   if($_)..   {.. 
0e30: 20 20 20 20 20 69 66 28 24 63 6f 6c 6c 65 63 74       if($collect
0e40: 69 6f 6e 4d 65 74 68 6f 64 29 0d 0a 20 20 20 20  ionMethod)..    
0e50: 20 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 24 69    {..         $i
0e60: 6e 70 75 74 4f 62 6a 65 63 74 2e 41 64 64 28 24  nputObject.Add($
0e70: 5f 29 20 7c 20 6f 75 74 2d 6e 75 6c 6c 0d 0a 20  _) | out-null.. 
0e80: 20 20 20 20 20 7d 20 65 6c 73 65 20 7b 0d 0a 20       } else {.. 
0e90: 20 20 20 20 20 20 20 20 24 73 65 65 6e 2b 2b 0d          $seen++.
0ea0: 0a 20 20 20 20 20 20 20 20 20 69 66 28 24 73 65  .         if($se
0eb0: 65 6e 20 2d 6c 74 20 24 63 6f 75 6e 74 29 20 7b  en -lt $count) {
0ec0: 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20 24 73  ..            $s
0ed0: 65 6c 65 63 74 65 64 5b 24 73 65 65 6e 2d 31 5d  elected[$seen-1]
0ee0: 20 3d 20 24 5f 0d 0a 20 20 20 20 20 20 20 20 20   = $_..         
0ef0: 7d 20 23 23 20 46 6f 72 20 65 61 63 68 20 69 6e  } ## For each in
0f00: 70 75 74 20 65 6c 65 6d 65 6e 74 20 24 6e 20 74  put element $n t
0f10: 68 65 72 65 20 69 73 20 61 20 24 63 6f 75 6e 74  here is a $count
0f20: 2f 24 6e 20 63 68 61 6e 63 65 20 74 68 61 74 20  /$n chance that 
0f30: 69 74 20 62 65 63 6f 6d 65 73 20 70 61 72 74 20  it becomes part 
0f40: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 2e 0d 0a  of the result...
0f50: 20 20 20 20 20 20 20 20 20 65 6c 73 65 69 66 28           elseif(
0f60: 24 72 61 6e 64 2e 4e 65 78 74 44 6f 75 62 6c 65  $rand.NextDouble
0f70: 28 29 20 2d 6c 74 20 28 24 63 6f 75 6e 74 2f 24  () -lt ($count/$
0f80: 73 65 65 6e 29 29 0d 0a 20 20 20 20 20 20 20 20  seen))..        
0f90: 20 7b 0d 0a 20 20 20 20 20 20 20 20 20 20 20 20   {..            
0fa0: 23 23 20 46 6f 72 20 74 68 65 20 6f 6e 65 73 20  ## For the ones 
0fb0: 70 72 65 76 69 6f 75 73 6c 79 20 73 65 6c 65 63  previously selec
0fc0: 74 65 64 2c 20 74 68 65 72 65 27 73 20 61 20 31  ted, there's a 1
0fd0: 2f 24 6e 20 63 68 61 6e 63 65 20 6f 66 20 69 74  /$n chance of it
0fe0: 20 62 65 69 6e 67 20 72 65 70 6c 61 63 65 64 0d   being replaced.
0ff0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 24 73 65  .            $se
1000: 6c 65 63 74 65 64 5b 24 72 61 6e 64 2e 4e 65 78  lected[$rand.Nex
1010: 74 28 30 2c 24 63 6f 75 6e 74 29 5d 20 3d 20 24  t(0,$count)] = $
1020: 5f 0d 0a 20 20 20 20 20 20 20 20 20 7d 0d 0a 20  _..         }.. 
1030: 20 20 20 20 20 7d 0d 0a 20 20 20 7d 0d 0a 7d 0d       }..   }..}.
1040: 0a 45 4e 44 20 7b 0d 0a 20 20 20 69 66 20 28 2d  .END {..   if (-
1050: 6e 6f 74 20 24 69 6e 70 75 74 4f 62 6a 65 63 74  not $inputObject
1060: 29 0d 0a 20 20 20 7b 20 20 23 23 20 44 4f 20 4f  )..   {  ## DO O
1070: 4e 43 45 3a 20 28 6f 6e 6c 79 20 6f 6e 20 74 68  NCE: (only on th
1080: 65 20 72 65 2d 69 6e 76 6f 6b 65 2c 20 6e 6f 74  e re-invoke, not
1090: 20 77 68 65 6e 20 75 73 69 6e 67 20 2d 69 6e 70   when using -inp
10a0: 75 74 4f 62 6a 65 63 74 29 0d 0a 20 20 20 20 20  utObject)..     
10b0: 20 57 72 69 74 65 2d 56 65 72 62 6f 73 65 20 22   Write-Verbose "
10c0: 53 65 6c 65 63 74 65 64 20 24 63 6f 75 6e 74 20  Selected $count 
10d0: 6f 66 20 24 73 65 65 6e 20 65 6c 65 6d 65 6e 74  of $seen element
10e0: 73 2e 22 0d 0a 20 20 20 20 20 20 57 72 69 74 65  s."..      Write
10f0: 2d 4f 75 74 70 75 74 20 24 73 65 6c 65 63 74 65  -Output $selecte
1100: 64 0d 0a 20 20 20 20 20 20 23 20 66 6f 72 65 61  d..      # forea
1110: 63 68 28 24 65 6c 20 69 6e 20 24 73 65 6c 65 63  ch($el in $selec
1120: 74 65 64 29 20 7b 20 57 72 69 74 65 2d 4f 75 74  ted) { Write-Out
1130: 70 75 74 20 24 65 6c 20 7d 0d 0a 20 20 20 7d 20  put $el }..   } 
1140: 0d 0a 20 20 20 65 6c 73 65 20 0d 0a 20 20 20 7b  ..   else ..   {
1150: 0d 0a 20 20 20 20 20 20 57 72 69 74 65 2d 56 65  ..      Write-Ve
1160: 72 62 6f 73 65 20 28 22 7b 30 7d 20 65 6c 65 6d  rbose ("{0} elem
1170: 65 6e 74 73 2c 20 73 65 6c 65 63 74 69 6e 67 20  ents, selecting 
1180: 7b 31 7d 2e 22 20 2d 66 20 24 69 6e 70 75 74 4f  {1}." -f $inputO
1190: 62 6a 65 63 74 2e 43 6f 75 6e 74 2c 20 24 43 6f  bject.Count, $Co
11a0: 75 6e 74 29 0d 0a 20 20 20 20 20 20 66 6f 72 65  unt)..      fore
11b0: 61 63 68 28 24 69 20 69 6e 20 31 2e 2e 24 43 6f  ach($i in 1..$Co
11c0: 75 6e 74 29 20 7b 0d 0a 20 20 20 20 20 20 20 20  unt) {..        
11d0: 20 57 72 69 74 65 2d 4f 75 74 70 75 74 20 24 69   Write-Output $i
11e0: 6e 70 75 74 4f 62 6a 65 63 74 5b 24 72 61 6e 64  nputObject[$rand
11f0: 2e 4e 65 78 74 28 30 2c 24 69 6e 70 75 74 4f 62  .Next(0,$inputOb
1200: 6a 65 63 74 2e 43 6f 75 6e 74 29 5d 0d 0a 20 20  ject.Count)]..  
1210: 20 20 20 20 7d 20 20 20 0d 0a 20 20 20 7d 0d 0a      }   ..   }..
1220: 7d 0d 0a                                         }..