유니버설 인쇄 PowerShell 사용 사례 샘플

아티클
12/22/2023

UniversalPrintManagement PowerShell 모듈은 설정된 PowerShell 스크립팅 패턴을 지원합니다. 이 문서에서는 cmdlet을 결합하여 선택 사용 사례를 해결하는 방법의 시작점으로 일부 패턴을 보여 줍니다.

비대화형 유니버설 인쇄 연결

PowerShell을 사용하는 기본 값 중 하나는 반복해서 실행할 수 있는 비대화형 스크립트를 만드는 것입니다. 유니버설 인쇄에 대한 연결을 설정하기 위해 사용자 자격 증명을 입력해야 하는 것은 이 개념과 반대입니다. 한 가지 옵션은 사용자 암호 비밀을 안전하게 저장하고 필요에 따라 검색하는 것입니다.

암호 비밀을 파일에 안전하게 저장
호출 직전에 암호 검색 Connect-UPService

$Secure = Read-Host -AsSecureString
$Encrypted = ConvertFrom-SecureString -SecureString $Secure -Key (1..16)
$Encrypted | Set-Content Encrypted.txt
...
$Secure2 = Get-Content Encrypted.txt | ConvertTo-SecureString -Key (1..16)
Connect-UPService -UserPrincipalName username@tenantname.com -Password $Secure2

참고 항목

자세한 ConvertFrom-SecureString ConvertTo-SecureString 내용은 여기에서 확인할 수 있습니다.

커넥트or의 일괄 처리 등록 취소 프린터

프린터를 등록하는 데 사용된 등록된 커넥트 이름을 이미 알고 있다고 가정합니다. 등록된 커넥트 목록을 검색하려면 Get-UP커넥트or cmdlet을 참조하세요.

유니버설 인쇄에 커넥트
특정 커넥트or를 통해 등록된 프린터 목록을 가져옵니다.
등록된 프린터 제거

Connect-UPService
$ConnectorPrinters = Get-UPPrinter -IncludeConnectorDetails
$ConnectorPrinters.Results | Where-Object {$_.Connectors.DisplayName -Contains "<Connector Name>"} | Remove-UPPrinter

공유 프린터 이름 뒤에 등록된 프린터 식별

유니버설 인쇄에 커넥트
프린터 목록을 검색하고 로컬 컴퓨터를 사용하여 결과를 필터링합니다.

Connect-UPService
$Printers = Get-UPPrinter
$Printer = $Printers.Results | Where-Object {$_.Shares.DisplayName -eq "<Share Name>"}

공유 해제 프린터 일괄 처리

유니버설 인쇄에 커넥트
관심 있는 프린터 목록 가져오기
프린터 컬렉션 공유 해제

참고 항목

이 예제에서는 모든 공유 프린터의 공유 해제를 보여 줍니다. 선택한 프린터만 공유 해제하려면 프린터를 검색할 때 추가 필터를 추가할 수 있습니다.

Connect-UPService
$Printers = Get-UPPrinter
$Printers.Results.Shares | Remove-UPPrinterShare

일괄 처리로 모든 사용자에게 공유 프린터에 대한 액세스 권한 부여

유니버설 인쇄에 커넥트
관심 있는 프린터 공유 목록 가져오기
프린터 컬렉션에 대한 사용자 액세스 권한 부여

Connect-UPService
$PrinterShares = Get-UPPrinterShare
$PrinterShares.Results | Grant-UPAccess -AllUsersAccess

사용자 또는 사용자 그룹에 공유 프린터에 대한 액세스 권한 일괄 처리 부여

필수 조건: 사용자 ID 및 사용자 그룹 ID 검색
유니버설 인쇄에 커넥트
관심 있는 프린터 공유 목록 가져오기
특정 사용자 또는 그룹에게 프린터 컬렉션에 대한 액세스 권한 부여

Connect-AzAccount
$Users = Get-AzADUser -First 10
$UserGroups = Get-AzADGroup -SearchString Contoso

Connect-UPService
$PrinterShares = Get-UPPrinterShare
$Users | ForEach-Object {$PrinterShares.Results | Grant-UPAccess -UserID $_.Id}
$UserGroups | ForEach-Object {$PrinterShares.Results | Grant-UPAccess -GroupID $_.Id}

배치 집합 프린터 위치 속성

유니버설 인쇄에 커넥트
관심 있는 프린터 목록 가져오기
프린터 컬렉션에 대한 사용자 액세스 권한 부여

Connect-UPService
$Printers = Get-UPPrinter
$Printers.Results | Set-UPPrinterProperty -Latitude 47.642391 -Longitude -122.137001 -Organization "Contoso" -Site "Main Campus" -City "Redmond" -Building "101"

ContinuationToken 사용

유니버설 인쇄에 커넥트
관심 있는 프린터 목록 가져오기
일시적인 오류가 발생하면 연속 토큰과 함께 부분 결과가 반환됩니다.

Connect-UPService
$Printers = Get-UPPrinter

"Get-UPPrinter :
At line:1 char:13
+ $Printers = Get-UPPrinter
+             ~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (System.Collecti...Models.Printer]:List`1) [Get-UPPrinter], FailedCmdletException
    + FullyQualifiedErrorId : Rerun with -ContinuationToken to continue from last cutoff: MyZRVkZCUVVGQlFVRXZMeTh2THk4dkx5OHZMMGxCUVVGQk5IQTRiR
   EY0YWpOdU1DdEtPSG94T1dwUWNHWm5kejA5,Microsoft.UPManagement.Cmdlets.GetPrinter"

$Printers.Results
"(Partial results list of printers)"

$Printers.ContinuationToken
"MyZRVkZCUVVGQlFVRXZMeTh2THk4dkx5OHZMMGxCUVVGQk5IQTRiREY0YWpOdU1DdEtPSG94T1dwUWNHWm5kejA5"

$MorePrinters = Get-UPPrinter -ContinuationToken $Printers.ContinuationToken
$MorePrinters.Results
"(Printer results list continued from previously left off)"

ContinuationToken을 사용하면 결과를 더 강력하게 호출할 수 있습니다. 재시도를 추가하고 서로 추가할 수 있습니다. 등록된 프린터/커넥터/공유/등이 많고 전체 목록을 반복할 때 일관된 오류가 발생하는 테넌트에만 필요합니다.

do
{
    $i = Get-UPPrinter -ContinuationToken $i.ContinuationToken 
    $allprinters += $i.Results
}
while (![string]::IsNullOrEmpty($i.ContinuationToken))

$allprinters.Results

지난 달의 확장 사용자 및 프린터 사용 현황 보고서 다운로드

올바른 Microsoft Graph 모듈이 설치되어 있는지 확인합니다.
Microsoft Graph에 로그인
필요한 "Reports.Read.All" 권한 부여 범위 요청
프린터 보고서 수집 및 내보내기
사용자 보고서 수집 및 내보내기

Param (
    # Date should be in this format: 2020-09-01
    # Default is the first day of the previous month at 00:00:00 (Tenant time zone)
    $StartDate = "",
    # Date should be in this format: 2020-09-30
    # Default is the last day of the previous month 23:59:59 (Tenant time zone)
    $EndDate = "",
    # Set if only the Printer report should be generated
    [switch]$PrinterOnly,
    # Set if only the User report should be generated
    [switch]$UserOnly
)

#############################
# INSTALL & IMPORT MODULES
#############################

if(-not (Get-Module Microsoft.Graph.Reports -ListAvailable)){
    Write-Progress -Activity "Installing Universal Print dependencies..." -PercentComplete 60
    Install-Module Microsoft.Graph.Reports -Scope CurrentUser -Force
}
Import-Module Microsoft.Graph.Reports

#############################
# SET DATE RANGE
#############################
if ($StartDate -eq "") {
    $StartDate = (Get-Date -Day 1).AddMonths(-1).ToString("yyyy-MM-ddT00:00:00Z")
} else {
    $StartDate = ([DateTime]$StartDate).ToString("yyyy-MM-ddT00:00:00Z")
}

if ($EndDate -eq "") {
    $EndDate = (Get-Date -Day 1).AddDays(-1).ToString("yyyy-MM-ddT23:59:59Z")
} else {
    $EndDate = ([DateTime]$EndDate).ToString("yyyy-MM-ddT23:59:59Z")
}

echo "Gathering reports between $StartDate and $EndDate."

########################################
# SIGN IN & CONNECT TO MICROSOFT GRAPH
########################################

# These scopes are needed to get the list of users, list of printers, and to read the reporting data.
Connect-MgGraph -Scopes "Reports.Read.All"

##########################
# GET PRINTER REPORT
##########################

if (!$UserOnly)
{
    Write-Progress -Activity "Gathering Printer usage..." -PercentComplete -1

    # Get the printer usage report
    $printerReport = Get-MgReportMonthlyPrintUsageByPrinter -All -Filter "completedJobCount gt 0 and usageDate ge $StartDate and usageDate lt $EndDate"

    ## Join extended printer info with the printer usage report
    $reportWithPrinterNames = $printerReport | 
        Select-Object ( 
            @{Name = "UsageMonth"; Expression = {$_.Id.Substring(0,8)}}, 
            @{Name = "PrinterId"; Expression = {$_.PrinterId}}, 
            @{Name = "DisplayName"; Expression = {$_.PrinterName}}, 
            @{Name = "TotalJobs"; Expression = {$_.CompletedJobCount}},
            @{Name = "ColorJobs"; Expression = {$_.CompletedColorJobCount}},
            @{Name = "BlackAndWhiteJobs"; Expression = {$_.CompletedBlackAndWhiteJobCount}},
            @{Name = "ColorPages"; Expression = {$_.ColorPageCount}},
            @{Name = "BlackAndWhitePages"; Expression = {$_.BlackAndWhitePageCount}},
            @{Name = "TotalSheets"; Expression = {$_.MediaSheetCount}})

    # Write the aggregated report CSV
    $printerReport | Export-Csv -Path .\printerReport.csv
}

##################
# GET USER REPORT
##################

if (!$PrinterOnly)
{
    Write-Progress -Activity "Gathering User usage..." -PercentComplete -1

    # Get the user usage report
    $userReport = Get-MgReportMonthlyPrintUsageByUser -All -Filter "completedJobCount gt 0 and usageDate ge $StartDate and usageDate lt $EndDate"
    $reportWithUserInfo = $userReport | 
        Select-Object ( 
            @{Name = "UsageMonth"; Expression = {$_.Id.Substring(0,8)}}, 
            @{Name = "UserPrincipalName"; Expression = {$_.UserPrincipalName}}, 
            @{Name = "TotalJobs"; Expression = {$_.CompletedJobCount}},
            @{Name = "ColorJobs"; Expression = {$_.CompletedColorJobCount}},
            @{Name = "BlackAndWhiteJobs"; Expression = {$_.CompletedBlackAndWhiteJobCount}},
            @{Name = "ColorPages"; Expression = {$_.ColorPageCount}},
            @{Name = "BlackAndWhitePages"; Expression = {$_.BlackAndWhitePageCount}},
            @{Name = "TotalSheets"; Expression = {$_.MediaSheetCount}})
			        
    $reportWithUserInfo | Export-Csv -Path .\userReport.csv
}

echo "Reports were written to 'printerReport.csv' and 'userReport.csv'."

다음을 통해 공유