asvalue for gsnr (#179)

Author: gdbarron

RELEASE.md

@@ -1 +1,2 @@
-- Add `AsValue` parameter to `Export-ServiceNowAttachment` to return attachment contents instead of writing to a file
+- Add `AsValue` parameter to `Get-ServiceNowRecord` to return the underlying value for a property instead of a pscustomobject.  Get your sys_id directly!
+- Add formatting for Unique Certificate (cmdb_ci_certificate) table

ServiceNow/Public/Get-ServiceNowRecord.ps1

@@ -49,6 +49,11 @@
     For instance, an RITM may have custom variables, but the associated tasks may not.
     A property named 'CustomVariable' will be added to the return object.
 
+.PARAMETER AsValue
+    Return the underlying value instead of pscustomobject.
+    Only valid when the Property parameter is set to 1 item.
+    Helpful when retrieving sys_id for example.
+
 .PARAMETER Connection
     Azure Automation Connection object containing username, password, and URL for the ServiceNow instance
 
@@ -105,6 +110,10 @@
     Get-ServiceNowRecord -Table 'change request' -IncludeCustomVariable -First 5
     Get the first 5 change requests and retrieve custom variable info
 
+.EXAMPLE
+    Get-ServiceNowRecord -Table 'cmdb_ci' -Property sys_id -First 1 -AsValue
+    Get the underlying value for a property instead of a pscustomobject where the value needs to be extracted
+
 .EXAMPLE
     gsnr RITM0010001
     Get a specific record by number using the function alias
@@ -175,6 +184,9 @@ function Get-ServiceNowRecord {
         [Parameter()]
         [switch] $IncludeCustomVariable,
 
+        [Parameter()]
+        [switch] $AsValue,
+
         [Parameter()]
         [hashtable] $Connection,
 
@@ -336,12 +348,20 @@ function Get-ServiceNowRecord {
         else {
 
             # format the results
-            if ( -not $Property ) {
+            if ( $Property ) {
+                if ( $Property.Count -eq 1 -and $AsValue ) {
+                    $result | Select-Object -ExpandProperty $result.PSObject.Properties.Name
+                }
+                else {
+                    $result
+                }
+            }
+            else {
                 if ($thisTable.Type) {
                     $result | ForEach-Object { $_.PSObject.TypeNames.Insert(0, $thisTable.Type) }
                 }
+                $result
             }
-            $result
         }
     }
 }

ServiceNow/ServiceNow.format.ps1xml

@@ -472,5 +472,62 @@
 				</TableRowEntries>
 			</TableControl>
 		</View>
+		<View>
+			<Name>ServiceNow.UniqueCertificate</Name>
+			<ViewSelectedBy>
+				<TypeName>ServiceNow.UniqueCertificate</TypeName>
+			</ViewSelectedBy>
+			<TableControl>
+				<TableHeaders>
+					<TableColumnHeader>
+						<Label>name</Label>
+						<Width>30</Width>
+					</TableColumnHeader>
+					<TableColumnHeader>
+						<Label>valid_to</Label>
+						<Width>20</Width>
+					</TableColumnHeader>
+					<TableColumnHeader>
+						<Label>state</Label>
+						<Width>15</Width>
+					</TableColumnHeader>
+					<TableColumnHeader>
+						<Label>issuer</Label>
+						<Width>30</Width>
+					</TableColumnHeader>
+					<TableColumnHeader>
+						<Label>sys_id</Label>
+						<Width>32</Width>
+					</TableColumnHeader>
+				</TableHeaders>
+				<TableRowEntries>
+					<TableRowEntry>
+						<TableColumnItems>
+							<TableColumnItem>
+								<PropertyName>name</PropertyName>
+							</TableColumnItem>
+							<TableColumnItem>
+								<PropertyName>valid_to</PropertyName>
+							</TableColumnItem>
+							<TableColumnItem>
+								<PropertyName>state</PropertyName>
+							</TableColumnItem>
+							<TableColumnItem>
+								<ScriptBlock>
+								if ($_.issuer.display_value) {
+									$_.issuer.display_value
+								} else {
+									$_.issuer.value
+								}
+								</ScriptBlock>
+							</TableColumnItem>
+							<TableColumnItem>
+								<PropertyName>sys_id</PropertyName>
+							</TableColumnItem>
+						</TableColumnItems>
+					</TableRowEntry>
+				</TableRowEntries>
+			</TableControl>
+		</View>
 	</ViewDefinitions>
 </Configuration>