중앙 집중식 배포 PowerShell cmdlet을 사용하여 추가 기능 관리

아티클
04/04/2024

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