중앙 집중식 배포 PowerShell cmdlet을 사용하여 추가 기능 관리
Microsoft 365 사용자 관리자는 중앙 집중식 배포 기능을 통해 사용자에게 Office 추가 기능을 배포할 수 있습니다( 관리 센터에서 Office 추가 기능 배포 참조). Microsoft 365 관리 센터를 통해 Office 추가 기능을 배포하는 것 외에도 Microsoft PowerShell을 사용할 수도 있습니다. Windows PowerShell용 O365 중앙 집중식 Add-In 배포 모듈을 설치합니다.
모듈을 다운로드한 후 일반 Windows PowerShell 창을 열고 다음 cmdlet을 실행합니다.
Import-Module -Name O365CentralizedAddInDeployment
관리자 자격 증명을 사용하여 연결
중앙 집중식 배포 cmdlet을 사용하려면 로그인해야 합니다.
PowerShell을 시작합니다.
사용자 관리자 자격 증명을 사용하여 PowerShell에 연결합니다. 다음 cmdlet을 실행합니다.
Connect-OrganizationAddInService
- 열리는 로그인 프롬프트에서 Microsoft 365 사용자 관리자 자격 증명을 선택하거나 입력합니다.
참고
PowerShell 사용에 대한 자세한 내용은 PowerShell을 사용하여 Microsoft 365에 연결을 참조하세요.
추가 기능 매니페스트 업로드
New-OrganizationAdd-In cmdlet을 실행하여 파일 위치 또는 URL일 수 있는 경로에서 추가 기능 매니페스트를 업로드합니다. 다음 예제에서는 ManifestPath 매개 변수의 값에 대한 파일 위치를 보여줍니다.
New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'
다음 예제와 같이 New-OrganizationAdd-In cmdlet을 실행하여 추가 기능을 업로드하고 Members 매개 변수를 사용하여 사용자 또는 그룹에 직접 할당할 수도 있습니다. 멤버의 이메일 주소를 쉼표로 구분합니다.
New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members 'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'
Office 스토어에서 추가 기능 업로드
New-OrganizationAddIn cmdlet을 실행하여 Office 스토어에서 매니페스트를 업로드합니다.
다음 예제에서 New-OrganizationAddIn cmdlet 은 미국 위치 및 콘텐츠 시장의 추가 기능에 대한 AssetId를 지정합니다.
New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'
AssetId 매개 변수의 값을 확인하려면 추가 기능에 대한 Office Store 웹 페이지의 URL에서 복사할 수 있습니다. AssetIds는 항상 "WA"와 숫자로 시작합니다. 예를 들어 이전 예제에서 WA104099688 AssetId 값의 원본은 추가 기능에 대한 Office Store 웹 페이지 URL입니다 https://store.office.com/en-001/app.aspx?assetid=WA104099688.
Locale 매개 변수 및 ContentMarket 매개 변수의 값은 동일하며 추가 기능을 설치하려는 국가/지역을 나타냅니다. 형식은 en-US, fr-FR 등입니다.
참고
Office 스토어에서 업로드된 추가 기능은 Office 스토어에서 사용할 수 있는 최신 업데이트의 며칠 이내에 자동으로 업데이트됩니다.
추가 기능의 세부 정보 가져오기
아래와 같이 Get-OrganizationAddIn cmdlet 을 실행하여 테넌트로 업로드된 모든 추가 기능에 대한 세부 정보를 가져오고 추가 기능의 제품 ID를 포함합니다.
Get-OrganizationAddIn
ProductId 매개 변수 값으로 Get-OrganizationAddIn cmdlet을 실행하여 세부 정보를 검색할 추가 기능을 지정합니다.
Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122
모든 추가 기능과 할당된 사용자 및 그룹의 전체 세부 정보를 얻으려면 다음 예제와 같이 Get-OrganizationAddIn cmdlet 의 출력을 Format-List cmdlet으로 파이프합니다.
foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}
추가 기능 켜기 또는 끄기
추가 기능을 해제하여 할당된 사용자 및 그룹이 더 이상 액세스할 수 없도록 하려면 다음 예제와 같이 ProductId 매개 변수 및 Enabled 매개 변수를 로 설정하여 $falseSet-OrganizationAddIn cmdlet을 실행합니다.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false
추가 기능을 다시 켜려면 Enabled 매개 변수가 로 설정된 동일한 cmdlet을 실행합니다 $true.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true
추가 기능에서 사용자 추가 또는 제거
특정 추가 기능에 사용자 및 그룹을 추가하려면 ProductId, Add 및 Members 매개 변수를 사용하여 Set-OrganizationAddInAssignments cmdlet을 실행합니다. 멤버의 이메일 주소를 쉼표로 구분합니다.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'
사용자 및 그룹을 제거하려면 Remove 매개 변수를 사용하여 동일한 cmdlet을 실행합니다.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'
테넌트에서 모든 사용자에게 추가 기능을 할당하려면 값이 로 설정된 AssignToEveryone 매개 변수를 사용하여 동일한 cmdlet을 실행합니다 $true.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true
모든 사용자에게 추가 기능을 할당하지 않고 이전에 할당된 사용자 및 그룹으로 되돌리려면 동일한 cmdlet을 실행하고 값을 로 설정하여 AssignToEveryone 매개 변수를 해제할 $false수 있습니다.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false
추가 기능 업데이트
매니페스트에서 추가 기능을 업데이트하려면 다음 예제와 같이 ProductId, ManifestPath 및 Locale 매개 변수를 사용하여 Set-OrganizationAddIn cmdlet을 실행합니다.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'
참고
Office 스토어에서 업로드된 추가 기능은 Office 스토어에서 사용할 수 있는 최신 업데이트의 며칠 이내에 자동으로 업데이트됩니다.
추가 기능 삭제
추가 기능을 삭제하려면 다음 예제와 같이 ProductId 매개 변수를 사용하여 Remove-OrganizationAddIn cmdlet을 실행합니다.
Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122
각 cmdlet에 대한 자세한 도움말 보기
Get-help cmdlet을 사용하여 각 cmdlet에 대한 자세한 도움말을 볼 수 있습니다. 예를 들어 다음 cmdlet은 Remove-OrganizationAddIn cmdlet에 대한 자세한 정보를 제공합니다.
Get-help Remove-OrganizationAddIn -Full
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기