Merge pull request MicrosoftDocs#9974 from MicrosoftDocs/chrisda

Get/Set-Content -Encoding Byte fixe

Author: chrisda

skype/skype-ps/skype/Export-CsLisConfiguration.md

@@ -16,7 +16,6 @@ ms.reviewer:
 Exports an Enterprise Voice Enhanced 9-1-1 (E9-1-1) configuration to a file in compressed format for backup purposes.
 This cmdlet was introduced in Lync Server 2010.
 
-
 ## SYNTAX
 
 ### FileName
@@ -44,7 +43,6 @@ To return a list of all the role-based access control (RBAC) roles this cmdlet h
 
 `Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Export-CsLisConfiguration"}`
 
-
 ## EXAMPLES
 
 ### -------------------------- Example 1 --------------------------
@@ -65,27 +63,20 @@ In this example, the LIS configuration is stored as an array of bytes in a varia
 ```
 $lisconfig = Export-CsLisConfiguration -AsBytes
 
-$lisconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
+[System.IO.File]::WriteAllBytes('C:\E911Config.bak', $lisconfig)
 
-Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak | Import-CsLisConfiguration
+[System.IO.File]::ReadAllBytes('C:\E911Config.bak') | Import-CsLisConfiguration
 ```
 
 Example 3 is a more complete version of Example 2.
 The first line is the same, we call the Export-CsLisConfiguration cmdlet with the AsBytes parameter to store the LIS configuration as an array of bytes in the variable $lisconfig.
 The rest of this example shows how to save that configuration to a file and then import it back into the location configuration database.
 
-In line 2 we pipe the contents of $lisconfig, which is the byte array representing the LIS configuration, to the Windows PowerShell Set-Content cmdlet.
-We assign values to two parameters of the Set-Content cmdlet: Path and Encoding.
-We assign the full path and file name of the file to which we want to save the configuration to the Path parameter.
-We use the Encoding parameter with a value of byte to ensure the configuration is stored as an array of bytes.
+In line 2 we pipe the contents of $lisconfig, which is the byte array representing the LIS configuration, to the full path and file name of the file to which we want to save the configuration.
 
 Finally, in line 3 we import the configuration back into the location configuration database.
-First we call the Get-Content cmdlet to retrieve the contents from the file.
-We pass a value of 0 to the ReadCount property, which tells the Get-Content cmdlet to read all the contents of the file at once rather than one line at a time.
-We again use the Encoding parameter with a value of byte to specify what type of data we're reading from the file.
-Finally we pass the file name to the Path parameter.
-The contents of the file that we read with the Get-Content cmdlet are piped to the Import-CsLisConfiguration cmdlet, which imports the saved configuration into the location database.
-
+First we retrieve the contents from the file.
+The contents of the file are then piped to the Import-CsLisConfiguration cmdlet, which imports the saved configuration into the location database.
 
 ## PARAMETERS
 
@@ -134,16 +125,13 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable
 
 ### None
 
-
 ## OUTPUTS
 
 ### Byte[]
 Returns a byte array when the AsBytes parameter is used.
 
-
 ## NOTES
 
-
 ## RELATED LINKS
 
 [Import-CsLisConfiguration](Import-CsLisConfiguration.md)

skype/skype-ps/skype/Get-CsCallParkOrbit.md

@@ -87,7 +87,7 @@ It does this by checking the StartsWith property of the NumberRangeStart object
 
 ### -------------------------- Example 6 --------------------------
 ```
-Get-CsCallParkOrbit | Where-Object {\[Char\]::IsDigit($_.NumberRangeStart\[0\])}
+Get-CsCallParkOrbit | Where-Object {[Char]::IsDigit($_.NumberRangeStart[0])}
 ```
 
 The command in this example returns all call park orbit ranges where no prefix has been assigned to the numbers in the range.

skype/skype-ps/skype/Import-CSAnnouncementFile.md

@@ -17,8 +17,6 @@ ms.reviewer:
 Imports an announcement file to the Announcement service audio library.
 This cmdlet was introduced in Lync Server 2010.
 
-
-
 ## SYNTAX
 
 ```
@@ -37,24 +35,18 @@ At that point the New-CsUnassignedNumber or Set-CsUnassignedNumber cmdlet can be
 
 Imported files must be WAV or WMA files.
 
-
-
 ## EXAMPLES
 
 ### -------------------------- EXAMPLE 1 -------------------------- 
 ```
 
-$a = Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte
+$a = [System.IO.File]::ReadAllBytes('.\GreetingFile.wav')
 
 Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav" -Content $a
 ```
 
 These commands import an audio file into the Announcement service File Store.
-Because audio files must be imported as byte arrays, we first need to call the Get-Content cmdlet to retrieve the audio file as an array of individual bytes.
-Get-Content is a Windows PowerShell built-in cmdlet to which we pass the name (including path) of the file we want to use for our announcement.
-Next we pass a value of 0 to the ReadCount parameter, meaning we want to read the whole file at once.
-We then pass a value of Byte to the Encoding parameter, which tells Get-Content that we want the contents of the file as an array of bytes.
-We assign that array to the variable $a.
+Because audio files must be imported as byte arrays, we first need to retrieve the audio file as an array of individual bytes. We assign that array to the variable $a.
 
 In the second line we call the Import-CsAnnouncementFile cmdlet to actually import the file.
 We pass the service Identity ApplicationServer:redmond.litwareinc.com to the Parent parameter, then we pass a name to the FileName parameter (WelcomeMessage.wav).
@@ -64,23 +56,21 @@ Finally, we pass the variable $a as the value to the Content parameter to read i
 ### -------------------------- EXAMPLE 2 -------------------------- 
 ```
 
-Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav" -Content (Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte)
+Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav" -Content ([System.IO.File]::ReadAllBytes('.\GreetingFile.wav'))
 ```
 
-Example 2 is identical to Example 1 except that we included the Get-Content command inside parentheses as a value to the Content parameter rather than calling that command on its own and assigning it to a variable.
-
+Example 2 is identical to Example 1 except that we included the command inside parentheses as a value to the Content parameter rather than calling that command on its own and assigning it to a variable.
 
 ### -------------------------- EXAMPLE 3 -------------------------- 
 ```
 
-Get-Content ".\GreetingFile.wav" -ReadCount 0 -Encoding Byte | Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav"
+[System.IO.File]::ReadAllBytes('.\GreetingFile.wav') | Import-CsAnnouncementFile -Parent ApplicationServer:redmond.litwareinc.com -FileName "WelcomeMessage.wav"
 ```
 
 Example 3 is yet another variation of Example 1.
-The difference in this example is that rather than use the Content parameter, we first call the Get-Content cmdlet, then pipe the results to Import-CsAnnouncementFile.
+The difference in this example is that rather than use the Content parameter, we first call the command to read the file, then pipe the results to Import-CsAnnouncementFile.
 This is the most reliable way of importing an announcement file from a remote session.
 
-
 ## PARAMETERS
 
 ### -Parent
@@ -119,6 +109,8 @@ Accept wildcard characters: False
 ### -Content
 The contents of the audio file as a byte array.
 
+A valid value for this parameter requires you to read the file to a byte-encoded object using the following syntax: `([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))`. You can use this command as the parameter value, or you can write the output to a variable (`$data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')`) and use the variable as the parameter value (`$data`).
+
 ```yaml
 Type: Byte[]
 Parameter Sets: (All)

skype/skype-ps/skype/Import-CsLisConfiguration.md

@@ -17,8 +17,6 @@ ms.reviewer:
 Imports an Enterprise Voice Enhanced 9-1-1 (E9-1-1) configuration from a backup file.
 This cmdlet was introduced in Lync Server 2010.
 
-
-
 ## SYNTAX
 
 ### ByteInput
@@ -48,11 +46,8 @@ You call the Export-CsLisConfiguration cmdlet to back up your configuration.
 Later, you modify the Location property of that wireless access point to Building30/Rooms20-40.
 If you then call the Import-CsLisConfiguration cmdlet to restore the backed-up configuration, the location for that WAP will be Building30/Room10 (the location before the backup), but the location for Building30/Rooms20-40 will remain in the location configuration database.
 
-
-
 ## EXAMPLES
 
-
 ### -------------------------- EXAMPLE 1 -------------------------- 
 ```
 
@@ -61,7 +56,6 @@ Import-CsLisConfiguration -FileName C:\E911Config.bak
 
 This example imports the E9-1-1 configuration from the backup file named E911Config.back to the location configuration database.
 
-
 ### -------------------------- EXAMPLE 2 -------------------------- 
 ```
 
@@ -78,34 +72,25 @@ In line 2 the Import-CsLisConfiguration cmdlet is called.
 The ByteInput parameter receives a value of $lisconfig, which is the variable containing the byte array we exported.
 This will import that byte array back into the location configuration database.
 
-
-
 ### -------------------------- EXAMPLE 3 -------------------------- 
 ```
 
 $lisconfig = Export-CsLisConfiguration -AsBytes
 
-$listconfig | Set-Content -Path C:\E911Config.bak -Encoding byte
+[System.IO.File]::WriteAllBytes('C:\E911Config.bak', $lisconfig)
 
-Get-Content -ReadCount 0 -Encoding byte -Path C:\E911Config.bak | Import-CsLisConfiguration
+[System.IO.File]::ReadAllBytes('C:\E911Config.bak') | Import-CsLisConfiguration
 ```
 
 Example 3 is a more complete version of Example 2.
 The first line is the same, we call the Export-CsLisConfiguration cmdlet with the AsBytes parameter to store the LIS configuration as an array of bytes in the variable $lisconfig.
 The rest of this example shows how to save that configuration to a file and then import it back into the location configuration database.
 
-In line 2 we pipe the contents of $lisconfig, which is the byte array representing the LIS configuration, to the Windows PowerShell Set-Content cmdlet.
-We assign values to two parameters of the Set-Content cmdlet: Path and Encoding.
-We assign the full path and file name of the file to which we want to save the configuration to the Path parameter.
-We use the Encoding parameter with a value of byte to ensure the configuration is stored as an array of bytes.
+In line 2 we pipe the contents of $lisconfig, which is the byte array representing the LIS configuration, to the full path and file name of the file to which we want to save the configuration.
 
 Finally, in line 3 we import the configuration back into the location configuration database.
-First we call the Get-Content cmdlet to retrieve the contents from the file.
-We pass a value of 0 to the ReadCount property, which tells the Get-Content cmdlet to read all the contents of the file at once rather than one line at a time.
-We again use the Encoding parameter with a value of byte to specify what type of data we're reading from the file.
-Finally we pass the file name to the Path parameter.
-The contents of the file that we read with the Get-Content cmdlet is piped to the Import-CsLisConfiguration cmdlet, which imports the saved configuration into the location configuration database.
-
+First we retrieve the contents from the file.
+The contents of the file are then piped to the Import-CsLisConfiguration cmdlet, which imports the saved configuration into the location database.
 
 ## PARAMETERS
 

skype/skype-ps/skype/Import-CsOnlineAudioFile.md

@@ -28,36 +28,27 @@ The Import-CsOnlineAudioFile cmdlet uploads a new audio file for use with the Au
 
 ### Example 1
 ```powershell
-$content = Get-Content "C:\Media\Hello.wav" -Encoding byte -ReadCount 0
+$content = [System.IO.File]::ReadAllBytes('C:\Media\Hello.wav')
 $audioFile = Import-CsOnlineAudioFile -ApplicationId "OrgAutoAttendant" -FileName "Hello.wav" -Content $content
 ```
 
 This example creates a new audio file using the WAV content that has a filename of Hello.wav to be used with organizational auto attendants. The stored variable, $audioFile, will be used when running other cmdlets to update the audio file for Auto Attendant, for example [New-CsAutoAttendantPrompt](https://learn.microsoft.com/powershell/module/skype/new-csautoattendantprompt).
 
 ### Example 2
 ```powershell
-$content = Get-Content "C:\Media\MOH.wav" -Encoding byte -ReadCount 0
+$content = [System.IO.File]::ReadAllBytes('C:\Media\MOH.wav')
 $audioFile = Import-CsOnlineAudioFile -ApplicationId "HuntGroup" -FileName "MOH.wav" -Content $content
 ```
 
-This example creates a new audio file using the WAV content that has a filename of MOH.wav to be used as a Music On Hold file with a Call Queue. The stored variable, $audioFile, will be used with [Set-CsCallQueue](https://learn.microsoft.com/powershell/module/skype/set-cscallqueue) to provide the audio file id. 
+This example creates a new audio file using the WAV content that has a filename of MOH.wav to be used as a Music On Hold file with a Call Queue. The stored variable, $audioFile, will be used with [Set-CsCallQueue](https://learn.microsoft.com/powershell/module/skype/set-cscallqueue) to provide the audio file id.
 
 ### Example 3
 ```powershell
-$content = Get-Content "C:\Media\MOH.wav" -Encoding byte -ReadCount 0
+$content = [System.IO.File]::ReadAllBytes('C:\Media\MOH.wav')
 $audioFile = Import-CsOnlineAudioFile -ApplicationId TenantGlobal -FileName "MOH.wav" -Content $content
 ```
 
-This example creates a new audio file using the WAV content that has a filename of MOH.wav to be used as Music On Hold for Microsoft Teams. The stored variable, $audioFile, will be used with [New-CsTeamsCallHoldPolicy](https://learn.microsoft.com/powershell/module/skype/new-csteamscallholdpolicy) to provide the audio file id. 
-
-### Example 4
-```powershell
-$content = Get-Content "C:\Media\MOH.wav" -AsByteStream -ReadCount 0
-$audioFile = Import-CsOnlineAudioFile -ApplicationId 'TenantGlobal' -FileName 'MOH.wav' -Content $content
-```
-
-This example uses the `-AsByteStream` parameter instead of the `-Encoding byte` parameter. Requires PowerShell 6 and later versions, where `-Encoding byte` is no longer available. The example creates a new audio file using the WAV content that has a filename of MOH.wav to be used as Music On Hold for Microsoft Teams. The stored variable, $audioFile, will be used with [New-CsTeamsCallHoldPolicy](New-CsTeamsCallHoldPolicy.md) to provide the audio file id. 
-
+This example creates a new audio file using the WAV content that has a filename of MOH.wav to be used as Music On Hold for Microsoft Teams. The stored variable, $audioFile, will be used with [New-CsTeamsCallHoldPolicy](https://learn.microsoft.com/powershell/module/skype/new-csteamscallholdpolicy) to provide the audio file id.
 
 ## PARAMETERS
 

skype/skype-ps/skype/Import-CsRgsAudioFile.md

@@ -17,8 +17,6 @@ ms.reviewer:
 Imports a new audio file for use with the Response Group application.
 This cmdlet was introduced in Lync Server 2010.
 
-
-
 ## SYNTAX
 
 ```
@@ -37,14 +35,12 @@ Note that you must run Import-CsRgsAudioFile each time you want to use an audio
 For example, suppose Workflow A uses a given audio file as its custom music on hold file and you now want to use that same audio file as the custom music on hold for Workflow B.
 Even though the audio file is already used by the Response Group application you will still need to import the file in order to use it with Workflow B.
 
-
-
 ## EXAMPLES
 
 ### -------------------------- EXAMPLE 1 -------------------------- 
 ```
 
-$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content (Get-Content C:\Media\WhileYouWait.wav -Encoding byte -ReadCount 0)
+$x = Import-CsRgsAudioFile -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -FileName "WhileYouWait.wav" -Content ([System.IO.File]::ReadAllBytes('C:\Media\WhileYouWait.wav'))
 
 $y = Get-CsRgsWorkflow -Identity "service:ApplicationServer:atl-cs-001.litwareinc.com" -Name "Help Desk Workflow"
 
@@ -58,16 +54,14 @@ To perform this task, the first command uses Import-CsRgsAudioFile to import the
 In addition to the Identity parameter (which specifies the service location) the FileName parameter is used to specify the file name of the file being imported.
 
 At the same time, the Content parameter is used to import the audio file.
-File importing is carried out by calling the Get-Content cmdlet followed by the path to the file being imported.
-Get-Content also requires you to set the encoding type to byte and the ReadCount to 0.
-(Setting the ReadCount to 0 ensures that the entire file is read in a single operation.) The imported file is then stored in a variable named $x.
+File importing is carried out by calling the `[System.IO.File]::ReadAllBytes` command with the path to the file being imported.
+The imported file is then stored in a variable named $x.
 
 In the second command, Get-CsRgsWorkflow is used to create an object reference ($y) to the workflow Help Desk Workflow.
 After this object reference has been created, command 3 sets the value of the CustomMusicOnHoldFile property to $x, the variable containing the imported audio file.
 Finally, the last command in the example uses Set-CsRgsWorkflow to write these changes to the actual workflow Help Desk Workflow.
 If you do not call Set-CsRgsWorkflow, your modifications will exist only in memory, and will disappear as soon as you close Windows PowerShell or delete the variables $x or $y.
 
-
 ## PARAMETERS
 
 ### -Identity
@@ -89,8 +83,8 @@ Accept wildcard characters: False
 
 ### -Content
 Actual content of the audio file being imported.
-The Content property is populated by calling the Get-Content cmdlet.
-When calling Get-Content, set the Encoding parameter to byte and the ReadCount parameter to 0 (for details, see the Examples section in this topic).
+
+A valid value for this parameter requires you to read the file to a byte-encoded object using the following syntax: `([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))`. You can use this command as the parameter value, or you can write the output to a variable (`$data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')`) and use the variable as the parameter value (`$data`).
 
 ```yaml
 Type: Byte[]

skype/skype-ps/skype/New-CsAutoAttendantPrompt.md

@@ -48,7 +48,7 @@ This example creates a new prompt that reads the supplied text.
 
 ### -------------------------- Example 2 --------------------------
 ```powershell
-$content = Get-Content "C:\Media\hello.wav" -Encoding byte -ReadCount 0
+$content = [System.IO.File]::ReadAllBytes('C:\Media\hello.wav')
 $audioFile = Import-CsOnlineAudioFile -ApplicationId "OrgAutoAttendant" -FileName "hello.wav" -Content $content
 $audioFilePrompt = New-CsAutoAttendantPrompt -AudioFilePrompt $audioFile
 ```
@@ -57,7 +57,7 @@ This example creates a new prompt that plays the selected audio file.
 
 ### -------------------------- Example 3 --------------------------
 ```powershell
-$content = Get-Content "C:\Media\hello.wav" -Encoding byte -ReadCount 0
+$content = [System.IO.File]::ReadAllBytes('C:\Media\hello.wav')
 $audioFile = Import-CsOnlineAudioFile -ApplicationId "OrgAutoAttendant" -FileName "hello.wav" -Content $content
 $dualPrompt = New-CsAutoAttendantPrompt -ActiveType AudioFile -AudioFilePrompt $audioFile -TextToSpeechPrompt "Welcome to Contoso!"
 ```

skype/skype-ps/skype/New-CsClientPolicy.md

@@ -1355,9 +1355,7 @@ To search only last name, first name, and display name you would construct this
 After the binary value has been constructed, it must then be converted to a decimal value before being assigned to SearchPrefixFlags.
 To convert a binary number to a decimal number, you can use the a Windows PowerShell command similar to this:
 
-`\[Convert\]::ToInt32("1110111", 2)`
-
-
+`[Convert]::ToInt32("1110111", 2)`
 
 ```yaml
 Type: UInt16